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INTRODUCTION 

This course is designed for the programmer of an RSX-11M 
system. A system programmer must troubleshoot system problems and 
write needed privileged code. 

As a system programmer, your responsibilities will include 
the following : 

Determining features needed on system. 

Performing System Generations (SYSGENs) . 

Maintaining the software by installing patches. 

Determining the cause(s) of system crashes. 

Providing needed privileged tasks. 

Writing new directive code. 

Assisting application programmers with system problems. 

This course is designed to give you the knowledge and skills 
necessary to carry out these tasks. 



COURSE GOALS 

Upon completing this course, you should be able to: 

1. Install and maintain RSX-11M software. 

2. Use output from CDA to solve system problems. 

3. Write privileged tasks which access the system data base. 

4. Write privileged tasks which call system routines. 

5. Write a new directive processing routine and add the directive 
to the system. 

6. Determine system status by examining the system data base. 

7. Use knowledge of the operating system to improve performance 
of applications software. 
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NON-GOALS 

The following are not goals of this course: 

1. The course does not teach you how to write a device driver. 

2. The course does not teach you how to create a user-written 
Command Line Interpreter. 

3. The course does not teach you how to make any modifications to 
system source code. Specifically, it will not teach you how 
to modify DCL in any way. 

PREREQUISITES 

You should have already taken RSX-11M s Programming in 
FORTRAN/MACRO, or have equivalent experience using RSX-11M. You 
should also be able to read and understand MACRO-11 code. 

COURSE ORGANIZATION 

The student workbook handout is organized into modules which 
correspond to the major topics covered by the instructor during 
the course. Each module is designed to support the lecture by 
providing you with notes and exercises to guide your study. 

A module is composed of five parts: 

1. An Introduction which provides an overview of the module. It 
explains in general terms what the module covers and how the 
material within the module is related to your needs. Often, 
it introduces some of the important concepts detailed in the 
module . 

2. Objectives which list the knowledge and skills you should 
obtain as a result of studying the module. Read these before 
the corresponding lecture, and review them after completion of 
the module and its exercises. 

3. Resources which provide a list of reference materials for 
further information about the topics of the module and related 
topics. You should familiarize yourself with the reference 
materials because they are your primary source of information 
after you complete the course. 

Your instructor may suggest selected readings as preparation 
for a lecture, or for review and study after the lecture. 
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The module text which provides brief notes on topics covered 
in the lecture, with printed copies of lists, tables, 
diagrams, etc. your instructor may use in class. The texts 
provide you with notes to review after the lecture, and 
reduces somewhat the note-taking you must do during lecture. 

Note that the module text is a supplement to the lecture. It 
is not intended to be tutorial reading for learning the 
material on your own. Nor is it intended to replace the 
function of reference manuals which fully document the 
software. You are strongly encouraged to supplement these 
notes with notes of your own and with references to the system 
documentation. 

Module Exercises which are designed to help you practice and 
test the knowledge acquired during lecture and study. If you 
can perform all of the written and/or lab exercises at the end 
of the module, you have mastered the objectives of that 
module. 

Your instructor may suggest particular lab exercises to 
concentrate on, if time or equipment limitations make it 
impossible to perform all of them. In addition, your 
instructor may provide additional suggestions for lab 
activities. 



Modules 

There are thirteen modules of this course. The following is 
a brief list of their major topics: 

1. OVERVIEW OF RSX-11M describes the operating system and its 
goals. 

2. THE SYSTEM DATA BASE describes the most important data 
structures and lists in the system data base. 

3. EXECUTIVE MODULES describes the most important Executive 
modules . 

4. FILE SYSTEM OVERVIEW describes the structure of a FILES-11 
volume and the data structures needed to process it. 

5. SYSTEM GENERATION describes the system generation process. 
(For reference only; this module is optional.) 

6. PHYSICAL AND VIRTUAL MEMORY describes partitions, allocation 
of memory to tasks, checkpointing, function and use of memory 
management. 
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7. TASK MANAGEMENT describes the life cycle of a task. 

8. SYSTEM SYNCHRONIZATION describes trap and interrupt 
processing, and access to the system data base. 

9. WRITING PRIVILEGED TASKS describes writing, assembling, and 
building privileged tasks. 

10. SYSTEM CRASHES uses CDA to troubleshoot system problems. 

11. DIRECTIVE PROCESSING describes the directive dispatcher, the 
directive dispatch table, and directive processing routines. 

12. I/O PROCESSING describes the components of the I/O system, 
ACPs, and QIO processing. 

13. DEVICE DRIVER PROCESSING describes the driver data base and 
the structure of standard device drivers. 
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RESOURCES 

1. RSX-11M Release Notes (AA-2573G-TC) 

Contains the most recent version information and should be 
read thoroughly before any system generation. Includes 
information on patching. 

2. RSX-11M System Generation and Installation Guide 

Contains complete documentation on the installation and SYSGEN 
procedures. 

3. RSX-llM/M-Plus I/O Operations Reference Manual 
Contains documentation on the FCS macros and subroutines. 

4. RSX-llM/M-Plus Executive Reference Manual 
Contains descriptions of all system directives. 

5. RSX-llM/M-Plus Crash Dump Analyzer 
Explains how to use the CDA facilities. 

6. RSX-11M Guide to Writing an I/O Driver 

Contains a detailed description of the procedures involved in 
writing a new device driver. 
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OVERVIEW OF RSX-11M 



INTRODUCTION 



RSX-11M is designed to support many applications with 
particular emphasis on real-time applications. For this reason, a 
large number of services are provided to the programmer. This 
module presents a brief overview of these features, many of which 
will be examined in detail in later modules. 



OBJECTIVES 



1. List the major design goals of RSX-11M, 

2. List the major features of RSX-11M. 

3. List the major components of RSX-11M. 
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DESIGN GOALS 

• Real-time system with 

8K word minimum Executive 

16K word minimal system (disk based, run time only) 

28K word system required for SYSGEN (version 4.0) 

• Upward compatible with RSX-11D 

• Support 

All PDP-11 processors 
Most processor options 
Full line of peripherals 

• Provide system and task synchronization not relying on task 
priorities 

• Provide extensive user facilities 

Complete file system 
Multiple language processors 
Debugging and maintainence tools 

• Allow for any number of simultaneously executing user tasks 

• Avoid using processor priority to synchronize access to system 
data base 



13 



OVERVIEW OF RSX-11M 



CHARACTERISTICS OF RSX- 1 1 M 

System Features 

• Supports multiprogramming 

Several tasks can be memory-resident and active at same 
time 

Improves efficiency of system 

Allows quick response to events 

• Provides some user control of some system functions 

Scheduling 
File access 

• Completely 'Event-Driven' 

No 'monolithic monitor" 

Executive entered only as a result of trap or hardware 
interrupt 

• Disk-Based 

Tasks stored on disk until loaded 
Allows quick task startup 

• Provides multi-tasking facilities 

Dynamic task requests 
Passing data between tasks 
Sharing memory areas between tasks 
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Major Components of RSX-11M 

• Executive - Contains code to perform system functions such as 
task scheduling, input/output operations, etc. 

• File System - Provides efficient and convenient access to data 
and task files. 

• Utilities - Provide services needed to program and support 
user applications. 
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THE EXECUTIVE 
Components 

• Trap and interrupt vectors - Used by hardware to provide trap 
and interrupt service. 

Vectors consist of 2 words: 

Word 1 - A value to go into the PC 
Word 2 - A value to go into the PS 

When a trap or interrupt occurs: 

Current values of PC and PS are pushed onto the stack 

Values in the vector are moved into the PC and PS 



• System Stack - Maintained as temporary storage for system 
programs. 

• System Common - Contains pointers to important areas of system 
data base. 

• Executive Code - Performs system functions. 

• Dynamic Storage Area - Contains most dynamically created 
system data structures. 

Use of Physical Memory 

• Executive contained in lowest area of memory 

• Size depends on features chosen at SYSGEK;. not greater than 
20K words 

• Executive has access to I/O page in top 4K words of address 
space 

• Some device drivers may not be included within Executive 

• Some directive service routines may not be included within the 
Executive 
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Figure 1-1 Typical Use of Physical Memory 
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THE FILE SYSTEM 

Design Goals 

• Allow programmer to organize data in a convenient manner 

• Provide protection from unauthorized access 

• Provide efficient use of disk space 

Components 

• Standard structures on disk and tape volumes 

• Ancillary control processor (ACP) to provide programming 
interface to file structured volumes 

F11ACP - For disk volumes 

MTAACP - For magnetic tape volumes 

• Application-oriented software 

FCS - File Control Services 

RMS - Record Management Services 
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Figure 1-2 The File System 
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THE UTILITIES 

• Tasks distributed with operating system 

Perform common maintenance and development functions 
Not included in memory-resident Executive 

• Four general categories of utilities 

Language processors 

MACRO-11 
FORTRAN 

Program development utilities 

EDT 
EDI 
LBR 

System maintenance utilities 

BAD 
CMP 
VFY 
PAT 

File manipulation utilities 

PIP 
FLX 
DMP 
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THE SYSTEM DATA BASE 



INTRODUCTION 

The system data base includes the data structures which 
describe the current state of the system to the Executive. Every 
operation within the system has its effect on the system data 
base. Similarly, the state of the system data base at the time an 
operation is requested determines the success and effect of the 
operation. 

Throughout this course, the system data base is used to 
explain the mechanics of various system operations. This module 
describes the most central system data structures, and how they 
are related. Future modules detail the data structures and their 
linkages . 



OBJECTIVES 



1. Describe the major system data structures associated with task 
management. 

2. Describe the major system data structures associated with 
partition control. 

3. Describe the major system data structures associated with I/O 
device control. 

4. Describe how the Executive manages the Dynamic Storage Region. 
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STATIC AND DYNAMIC DATA STRUCTURES 

• Static data structures 

Created when system is built 
Contained in Executive modules 

Example: Data structures for standard devices selected at 
SYSGEN are in the Executive module SYSTB. 

• Dynamic data structures 

Created and eliminated as needed 

Contained in Dynamic Storage Region (DSR) 

Example: Data structures needed to define tasks to the 
system are in DSR. 

The Dynamic Storage Region 

• Contains dynamic data structures 

• Space allocated and deallocated as needed 

• Allocation of DSR: 

Performed by routines in module CORAL 
Length is multiple of 4 bytes 

Linked list of unallocated space is maintained by 
Executive 

No record of allocated space is kept 
First-fit algorithm is used 

List of preallocated I/O packets maintained if specified 
at SYSGEN 
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Figure 2-1 The List of Free Space in DSR 
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SCRAVL— 1 



POINTER TO NEXT FREE BLOCK 



SIZE OF FREE BLOCK (IN BYTES) 



POINTER TO NEXT FREE BLOCK 



SI2E OF FREE BLOCK (IN BYTES) 



POINTER TO NEXT FREE BLOCK=0 



SIZE OF FREE BLOCK (IN BYTES) 



POINTER TO NEXT FREE BLOCK 



SIZE OF FREE BLOCK (IN BYTES) 



POINTER TO NEXT FREE BLOCKsrQ «-< 



SIZE OF FREE BLOCK (IN BYTES) 



i— SCRAVL 



Figure 2-2 Allocating DSR 
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BEFORE DEALLOCATION 



SCRAVL- 




POINTER TO NEXT FREE BLOCK 



SIZE OF FREE BLOCK (IN BYTES) 



POINTER TO NEXT FREE BLOCK 



SIZE OF FREE BLOCK (IN BYTES) 



HlllllMlllllHIIIII/llllIlllIlIII/J/lll/lll 



*» POINTER TO NEXT 



m:n.iH:<n.i 



SIZE OF FREE BLOCK (IN BYTES) 



AFTER DEALLOCATION 




POINTER TO NEXT FREE BLOCK 



SIZE OF FREE BLOCK (IN BYTES) 



DEALLOCATED SPACE 




POINTER TO NEXT FREE BLOCK 



SIZE OF FREE BLOCK (IN BYTES) 




POINTER TO NEXT FREE BLOCKrQ 



SIZE OF FREE BLOCK (IN BYTES) 



r— SCRAVL 



Figure 2-3 Deallocating DSR 
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TASK-RELATED DATA STRUCTURES AND LISTS 
The Task Control Block (TCB) 

• Defines task to system 

• Contains information controlling task execution 

Task name 
Task priority 
Local event flags 
Task status words 

• Contains pointers to other data structures including: 
T.RCVL - Receive queue listhead 

Points to linked list of data blocks queued 
by the 'SEND DATA' directive. 

T.ASTL - AST queue listhead 

Points to linked list of ASTs queued to task. 

T.UCB - Address of data structure (UCB) identifying TI 

T.TCBL - Link word for System Task Directory 

T.PCB - Address of data structure (PCB) identifying 
partition in which task executes 

T.ACTL - Link word for Active Task List 

• Allows task to load and begin execution quickly 

Contains pointer to task image on disk 
Identifies partition in which to load task 
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OPTIONAL 
AREA 



y 


UTILITY LINK WORD 


T.LNK 


/ 


I/O PENDING COUNT 


TASK PRIORITY 


T.IOC/T.PRI 


TCB 




POINTER TO CHECKPOINT PCB 


T.CPCB 


FIXED 


TASK NAME 


T.NAM 


IN RAD50 




RECEIVE QUEUE 


T.RCVL 


AREA 


LISTHEAD 




AST QUEUE 


T.ASTL 


PLAS AREA 


LISTHEAD 




TASK LOCAL 


T.EFLG 


PARENT/OFFSPRING 
AREA 


EVENT FLAGS 




UCB ADDRESS FOR 'Tl' 


T.UCB 


OTHER OPTIONS 


STD THREAD WORD 


T.TCBL 


FIRST STATUS WORD (BLOCKING BITS) 


T.STAT 



Figure 2-4 The Task Control Block 
(First Part of Fixed Area) 







FIRST STATUS WORD (BLOCKING BITS) 


T.STAT 




TCB 


/ 
\ 


SECOND STATUS WORD (STATE BITS) 


T.ST2 




FIXED 


THIRD STATUS WORD (ATTRIBUTE BITS) 


T.ST3 




LBN 


DEFAULT PRIORITY 


T.LBN/T.DPRI 




OF TASK LOAD IMAGE 






AREA 


UCB ADDRESS OF LOAD DEVICE 


T.LOV 




PCB ADDRESS OF TASK PARTITION 


T.PCB 


c 


PLAS AREA 


MAXIMUM SIZE OF TASK IMAGE (MAPPEDI 


T.MXSZ 


1 


ATL THREAD WORD 


T.ACTL 


OPTIONAL 
AREA I 


PARENT/OFFSPRING 
AREA 


SPECIFIED AST LISTHEAD 


T.SAST 


BUFFERED I/O COUNTJ UNUSED 


T.TIO 




OTHER OPTIONS 


TASK SIZE 


T.TKSZ 


I 




1 







Figure 2-4 The Task Control Block 
(Second Part of Fixed Area) 
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TCB 



FIXED 
AREA 



r 



PLAS AREA 



OPTIONAL 
AREA^ 



PARENT/OFFSPRING 
AREA 



H 



OTHER OPTIONS 



'T.SRCT 



.GGF 



ATTACHMENT DESCRIPTOR 



LISTHEAD 



OFFSET IN PARTITION 



EFN COUNT FOR SREF 



RESERVED 



R ECEI VE-BY-R EFER ENCE 



LISTHEAD 



OFFSPRING CONTROL 



BLOCK LISTHEAD 



OUTSTANDING OFFSPRING COUNT 



EVENT FLAG MASK WORD 



EVENT FLAG MASK ADDRESS 



GGEF USE COUNT 



TASK HEADER LENGTH 



T.ATT 

T.OFF 

T.RRFL 

T.OCBH 

T.RDCT 
T.EFLM 

T.HDLN 



Figure 2-4 The Task Control Block 
(Optional Area) 
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Offset 


Bit 


Symbol 


Value 


T.STAT 


15 


TS.EXE 


100000 




14 


TS.RDN 


40000 




13 


TS.MSG 


20000 




12 


TS.NRP 


10000 




8 


TS.OUT 


400 




7 


TS.CKP 


200 




6 


TS.CKR 


100 



Table 2-1 Task Status Words 

Meaning 

Task not in execution 

I/O rundown in progress 

Abort message being output 

Task mapped to nonresident region 

Task is out of memory 

Task is being checkpointed 

Task checkpointing requested 

NOTE 
The bits in T.STAT are called blocking bits. 
They must all be clear for the Executive to 
context switch to the task. 

T.ST2 15 T2.AST 100000 AST in progress 

AST recognition disabled 

Task not checkpointable 

Checkpointing disabled 

Task stopped for event flag 

Task fixed in memory 

Task engaged in terminal I/O 

Dynamic checkpoint space allocation failure 

Task is being halted 

Task marked for abort 

Saved T2.STP on AST in progress 

Task stopped 

Saved T2.SPN on AST in progress 

Task suspended 

Saved T2.WFR on AST in progress 

Task in wait for state 

T.ST3 15 T3.ACP 100000 Ancillary control processor 

Inhibit post mortem dump 
Remove task on exit 
Task is privileged 

Task requested as external MCR function 
Task is slaved 

Task is a command line interpreter 
Task does not allow send data 
Checkpoint space allocated in task image 
Task has resident overlays 



15 


T2.AST 


100000 


14 


T2.DST 


40000 


13 


T2.CHK 


20000 


12 


T2.CKD 


10000 


11 


T2.SEF 


4000 


10 


T2.FXD 


2000 


9 


T2.TI0 


1000 


8 


T2.CAF 


400 


7 


T2.HLT 


200 


6 


T2.AB0 


100 


5 


T2. 


40 


4 


T2.STP 


20 


3 


T2. 


10 




T2.SPN 


4 


1 


T2. 


2 





T2.WFR 


1 


15 


T3.ACP 


100000 


14 


T3.PMD 


40000 


13 


T3.REM 


20000 


12 


T3.PRV 


10000 


11 


T3.MCR 


4000 


10 


T3.SLV 


2000 


9 


T3.CLI 


1000 


7 


T3.NSD 


200 


6 


T3.CAL 


100 


5 


T3.R0V 


40 
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The System Task Directory (STD) 

Linked list of TCBs 

Ordered by descending default priority 

Begins at listhead $TSKHD in System Common 

Linked through location T.TCBL in the TCB 

'Null Task' TCB is last entry 

'Null Task' used to anchor system task lists 

When 'Null Task' is scheduled, the idle loop is performed 
until another task becomes ready to run 

'Null Task' TCB in System Common 

'Null Task' never executes 

• TCB is inserted when task is installed 

• New TCB inserted after others of same priority 

• System maintains pointers (in SYSCM) to special tasks in STD 

$TKTCB - Current task TCB 

$TKNPT - Pointer to TCB of task termination task TKTN 

$MCRPT - Pointer to TCB of MCR task 

$LDRPT - Pointer to loader TCB 
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$TSKHD 



$RQSCH 



$TKTCB 



I T.PRI 



T.TCBL 



I T DPRI 



T.ACTL 



j T.PRI 



T.TCBL 



1 T.DPRI 



T.ACTL 



I T.PRI 



T.TCBL 



I T.DPRI 



QM 



T.TCBL 



I T.DPRI 



T.ACTL 



I T.PRI | 130 



T.TCBL 

I T.DPRI I 50 



T.ACTL 



T.TCBL-0 



T.ACTL 



TCB OF 
(TYPICALLY) 
LOADER TASK 



THIS TCB IS LOCATED IN THE 
EXECUTIVE MODULE SYSCM. 
IT IS THE NULL TASK'S TCB. 



Figure 2-5 The System Task Directory 
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The Active Task List (ATL) 

• Linked list of TCBs 

• Ordered by descending priority 

• Begins at $ACTHD in System Common 

• Linked through T.ACTL in TCB 

• 'Null Task' TCB is last entry 

• TCB inserted when requested; Task becomes active 

• New TCB inserted after others of same priority 
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STSKHD 
$ACTHD 



$RQSCH 



$TKTCB 




TCB OF 
TYPICALLY) 
LOADER TASK 



THIS TCB IS LOCATED IN THE 
EXECUTIVE MODULE SYSCM. 
IT IS THE NULL TASK'S TCB. 



Figure 2-6 The Active Task List 
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PARTITION-RELATED DATA STRUCTURES AND LISTS 
The Partition Control Block (PCB) 

• Defines partition to system 

• Contains information describing partition 

Partition name 

Physical starting address (32 word blocks number) 

Size of partition (in 32 word blocks) 

Partition busy word 

Partition status word 

Protection word 

Current UIC of owner task 

• Pointers to other data structures 

If subpartition PCB, pointer to the main partition PCB 
Pointer to next subpartition PCB 

Pointer to queue of TCBs of tasks waiting for space in 
partition 

Pointer to attachment descriptor block for task 
Pointer to task header of resident task 
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P. IOC 



| LINK TO NEXT PARTITION PCB 




2 

4 

6 

10 

12 

14 

16 

20 

22 

24 

26 

30 

32 

34 

36 

40 


P.LNK 


I/O COUNT | PRIORITY OF PARTITION 


P.PRI 


PARTITION NAME 


P.NAM 


(IN RADIX-50) 




POINTER TO NEXT SUB-PARTITION 


P.SUB 


POINTER TO MAIN PCB 


P.MAIN 


PHYSICAL START ADDRESS OF PARTITION 


P.REL\P.HDR 2 


SIZE OF PARTITION 


P.BLKS^P.SIZE 1 


PARTITION WAIT QUEUE LIST HEAD 


P.WAIT 


PARTITION SWAP SIZE (SYSTEM ONLY) 


P.SWS2 3 


PARTITION BUSY FLAGS 


P.BUSY (TWO B , 


TCB ADDR. OF OWNER/CURRENT UIC OF OWNER TASK 


P.TCB/P.OWN 


PARTITION STATUS FLAGS 


P.STAT 


POINTER TO TASK HEADER 


P.HDR 2 


PROTECTION WORD FOR PARTITION 


P.PRO 4 


ATTACHMENT DESCRIPTOR 


P. ATT 5 


LIST HEAD 





1 32 WORD BLOCKS FOR MAPPED SYSTEMS 
BYTES FOR UNMAPPED SYSTEMS 

2. P.HDR=P.REL IN UNMAPPED SYSTEMS 

3. FOR SUB-PARTITIONS OF SYSTEM CONTROLLED PARTITIONS 

4. MAPPED SYSTEMS ONLY 

5. MAPPED SYSTEM WITH PLAS ONLY 



Figure 2-7 The Partition Control Block 
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Table 2-2 Partition Status Word 

Bit Symbol Value Meaning 

15 PS. OUT 100000 Partition is out of memory 

14 PS.CKP 40000 Partition checkpoint in progress 

13 PS.CKR 20000 Partition checkpoint requested 

12 PS.CHK 10000 Partition is not checkpointable 

11 PS.FXD 4000 Partition is fixed 

10 PS. PER 2000 Parity error in partition 

9 PS.LIO 1000 Marked by shuffler for long I/O 

8 PS.NSF 400 Partition is not shufflable 

7 PS.COM 200 Library or common block 

6 PS. PIC 100 Position independent library of common 

5 PS. SYS 40 System controlled partition 

4 PS. DRV 20 Driver is loaded in partition 

3 PS. DEL 10 Partition should be deleted when not attached 

2 PS. APR 4 Starting APR 

1 2 Starting APR 

1 Starting APR 
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The Partition List 

Linked list of PCBs 

Linked in order of increasing base address 

Begins at location $PARHD in System Common 

Linked through P.LNK in PCB 

PCB created and inserted in list by 'SET /MAIN' or 'SET /SUB' 
MCR or VMR command 

PCBs of subpartitions 

Task partitions 

Linked into list using P.LNK 

Linked to PCB of main partition using P. SUB 

System-controlled partitions 

Linked to main partition PCB using P. SUB 
Not linked through P.LNK 
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SPARHD- 



-=**M 



-^ 



P.LNK 



P.SUB=0 



P. MAIN 



P.LNK 



P.SUB 



P.MAIN 



P.LNK 



P.SUB 



P.MAIN 



P.LNK 



P.SUB=0 



P.MAIN 



P.LNK=0 



P.SUB 



P.MAIN 
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ffi 



P.LNK=? 



P.SUB 



P.MAIN -J 



PJ.NK=? 



P.SUB=0 



P.MAIN 



I USER-CONTROLLED 
>MAIN PARTITION 
J WITHOUT SUBPARTITIONS 

\ 



USER-CONTROLLED 

MAIN PARTITION 

WITH 2 SUBPARTITIONS 



SYSTEM-CONTROLLED 
PARTITION WITH 
2 DYNAMICALLY 
CREATED SUBPARTITIONS 



PCBS OF DYNAMICALLY ALLOCATED 

SUBPARTITIONS ARE CHAINED ACCORDING 

TO THE BASE ADDRESSES OF THEIR SUBPARTITIONS 



Figure 2-8 The Partition List 



41 



THE SYSTEM DATA BASE 



NON-RESIDENT, 
NON-ACTIVE TASK 



RESIDENT TASK 



NON-RESIDENT 
ACTIVE TASK 



OTHER , 

resident/ 

TASK 1 




\ PCB OF 

/ MAIN PARTITION 



-\ 



DYNAMICALLY 
CREATED PCB 



\ DYNAMICALLY V 
/ CREATED PCB > 



DYNAMICALLY 
} CREATED PCB 
I (LAST) 



EACH ACTIVE TASK 
HAS ITS OWN 
DYNAMICALLY 
CREATED PCB. 

PCB'S OF RESIDENT 
TASKS ARE CHAINED 
ACCORDING TO THE 
BASE ADDRESS OF 
THEIR SUBPARTITION. 



Figure 2-9 Relationship Between Task and Partition Structures 
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DEVICE-RELATED DATA STRUCTURES AND LISTS 
The Device Control Block (DCB) 

• Describes physical device type 

• Contains information describing device 

Generic device name in ASCII (D.NAM) 

Physical units in system of this type (D.UNIT) 

Device functions supported (D.MSK) 

• Pointer to data structures describing physical units (D.UCB) 

• Pointer to entry points in device driver (D.DSP) 



LINK TO NEXT DCB 



POINTER TO FIRST UCB OF THIS DEVICE TYPE 



GENERIC DEVICE NAME (IN ASCII) 



HIGHEST UNIT NUMBER 



LOWEST UNIT NUMBER 



LENGTH OF EACH UCB OF THIS DEVICE TYPE 



POINTER TO DRIVER DISPATCH TABLE 



LEGAL FUNCTION MASK 



CODES 0-15 



CONTROL FUNCTION MASK CODES 0-15 



NO-OP FUNCTION MASK 



CODES 0-15 



ACP FUNCTION MASK 



CODES 0-15 



LEGAL FUNCTION MASK 



CODES 16-31 



CONTROL FUNCTION MASK CODES 16-31 



NO-OP FUNCTION MASK 



CODES 16-31 



ACP FUNCTION MASK 



CODES 16-31 



PCB ADDRESS OF LOADABLE DRIVER 



D.LNK 

2 D.UCB 

4 D.NAM 

6 D.UNIT 

10 D.UCBL 

12 D.DSP 

14 D.MSK 

16 

20 

22 

24 

26 

30 

32 

34 D.PCB 



Figure 2-10 The Device Control Block 
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The Device List 

• Linked list of DCBs 

• Ordered by inclusion in SYSTB and by order of loading 

• Begins at listhead $DEVHD in SYSCM 

• Linked through location D.LNK in DCB 



SYSCM 

(sdevhd) 



D.LNK 



DCB FOR LP: 



D.LNK 



DCB FOR DB: 



D.LNK 



DCB FOR DK: 



Figure 2-11 The Device List 
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Other Structures 

• The Unit Control Block (UCB) 

One UCB per physical unit of type 

Size depends on device type 

Contains data used to describe physical unit 

• The Status Control Block (SCB) 

One SCB per controller or per line if multiplexer 

Size depends on device type 

Contains data needed to control I/O operations 



SYSCM___^ 


D.LNK 




$devhd) 




DCB FOR LP: 


» 






■S 


D.UCB 


UCB FOR 
LP0: 








— ►> 


SCB 




D.UCBL 




























D.LNK 


— ■* 


UCB FOR 
DB0: 






DCB FOR DB: 








D.UCB 


» 


SCB 




D.UCBL 


UCB FOR 
DB1: 






















D.LNK 










DCB FOR DK: 








D.UCB 


— »» 


UCB FOR 
DK0: 


— ► 


SCB 




D.UCBL 


I 




V 











Figure 2-12 Other Data Structures 
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THE CLOCK QUEUE 

The Clock Queue Control Block 

• Describes time-dependent request 

• Contains eight words; last three depends on type of request 

• Five types of requests 

Mark Time 

Task request with periodic rescheduling 

Single shot task request 

Single shot internal subroutine (two types) 



C.EFN 3 



POINTER TO NEXT CLOCK QUEUE CONTROL BLOCK 



EVENT FLAG NUMBER 
(MARK TIME ONLY) 



REQUEST TYPE 



TCB ADDRESS OR SYSTEM SUBROUTINE ADDRESS 



ABSOLUTE TIME 
WHEN 



LOW ORDER PART 



REQUEST COMES DUE 



HIGH ORDER PART 



-TYPE 



DEPENDENT 



PARAMETERS- 



C.LNK 
2 C.RQT 
4 C.TCB 
6 C.TIM 
10 
12 
14 
16 



Figure 2-13 The Clock Queue Control Block 
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The Clock Queue 

• Linked list of Clock Queue Control Blocks 

• List ordered by increasing absolute time 

• Scanned by code in TDSCH when clock interrupt occurs 



SYSCM 

($clkhd)- 



DSR 




Figure 2-14 The Clock Queue 
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EXECUTIVE MODULES 



INTRODUCTION 



The Executive is composed of a number of modules. Each 
module contains code which performs a specific function or class 
of related functions. To effectively function as a systems 
programmer, you must be able to locate this code. This module 
provides a quick overview of the major modules in the Executive. 



OBJECTIVES 

1. Recognize the general function of a module (i.e., general, 
directive processing, or device driver). 

2. Locate the code which performs a given Executive function. 
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OVERVIEW 

• Over 90 possible modules in the Executive 

• Modules conditionally assembled using symbols contained in 
[11,10]RSXMC.MAC 

• Three types of modules: 

General Executive modules 

Have names which relate to function 
Example: SYSCM - System Common 

Directive Processing modules 
Have 5 character names 

First two characters are "DR' 

Last three characters indicate function 

Example: DRABO - Module for processing the abort 
directive 

Device Driver modules 

Have 5 character names 

First two characters indicate device type 
Last three characters are 'DRV 

Example: DKDRV - Device driver for RK05 disk drives 
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PRINCIPAL EXECUTIVE MODULES 

System Common (SYSCM) 

• Contains pointers to system lists 

$CRAVL - Pointer to first block of free pool space 

$TSKHD - Pointer to STD 

$ACTHD - Pointer to ATL 

$PARHD - Pointer to Partition List 

$DEVHD - Pointer to Device List 

$GGEF - Pointer to Group Global Event Flag List 

$CLKHD - Pointer to Clock Queue 

$FRKHD - Pointer to Fork Queue 

$CFLPT - Pointer to Checkpoint File PCB List 

$UMRWT - Pointer to UMR wait queue 

• Contains pointers to specific data blocks 

$HEADR - Pointer to header of current task 

$TKNPT - Pointer to TCB of TKTN 

$SHFPT - Pointer to TCB of shuffler 

$TKTCB - Pointer to TCB of current task 

$RQSCH - Pointer to TCB of requested task 

$MCRPT - Pointer to TCB of MCR 

SLDRPT - Pointer to TCB of loader 

• General system data 

$CMBEG - The TCB of the null task 

$UMRHD - First UMR mapping assignment block 

$CURPR - Current task priority 

$COMEF - Common event flags 

$PWRFL - Powerfail recovery request flag 

$ABTIM - Absolute time counter 

$STKDP - Stack depth indicator 

$INTCT - Clock interrupt ticks count 

$DYPMN - Days per month table 

$BTMSK - Bit mask table 

$IOABM - I/O active bitmap 

$TKPS - Ticks per second 

$CXDBL - Context switching disabled flag 
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System Entrance and Exit Routines (SYSXT) 

• Contains routines used for entering and exiting the Executive 



$DIRSV 

$FORK 

$F0RK1 

$F0RK2 

$INTSV 

$INTSE 

$INTSC 
$INTXT 
$DIRXT 
$SWSTK 



Called 

Used to 

Used to 

Used to 

Called 

Called 

Logging 

Called 

Called 

Called 

Called 



when Executive entered by system trap 
create FORK process by driver 
create FORK process by non-driver 
create FORK process by CINT$ routine 
when Exec entered by interrupt 
when Exec entered by interrupt (Error 
) 

when Exec entered by interrupt (CINT$) 
to exit the Exec after an interrupt 
to exit the Exec after a system trap 
to enter the Exec from a privileged task 



• Contains code for the system 'idle loop 1 



DSR Allocation Routines (CORAL) 

• Contains routines used to allocate space in DSR 

$ALOCB - Allocates a block of specified size from DSR 
$ALCLK - Allocates a clock queue control block from DSR 
$DECLK - Deallocates a clock queue control block 
$ALPKT - Allocates a 'send' or I/O request block 
$DEPKT - Deallocates a 'send' or I/O request block 
$DEACB - Deallocates a block 
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I/O Related Routines (IOSUB) 

• Contains routines used in I/O-related processing 

$GTPKT - Gets I/O packet from I/O queue 

$GSPKT - Gets I/O packet 

$IODON - Handles common I/O completion 



PLAS Routines (PLSUB) 

• Contains subroutines used to manipulate Program 
Address Space (PLAS) 



Logical 



$SRNAM - Searches for specified partition 

$CKACC - Checks if desired access to region is allowed 

$CRATT - Creates Attachment Descriptor Block (ADB) 

$SRATT - Searches for specified ADB 

$SRWND - Searches for specified address window 

$UNMAP - Unmaps address window 

Queue Manipulation Routines (QUEUE) 

• Contains subroutines used to manipulate queues 

$CLINS - Inserts an entry into the clock queue 

$CLRMV - Removes an entry from the clock queue 

$QINSF - Inserts into FIFO queue 

$QINSP - Inserts into priority queue 

$QMCRL - Queues MCR command line 

$QRMVF - Removes from front of queue 

$QRMVT - Removes next entry with specified TCB address 
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Task Request Related Routines (REQSB) 

• Contains subroutines used to handle task requests 

$ABCTK - Aborts current task 

$ABTSK - Aborts specified task 

$BILDS - Sets up task stack and initialize task header 

5ACTTK - Puts task in Active Task List (ATL) 

$SETCR - Sets conditional scheduling request 

$SETF - Sets event flag 

$DASTT - Declares a no n- I/O related AST 

$QASTT - Queues an AST to a specified task 

$SRAST - Searches for specified type of AST 

$SRSTD - Searches STD for specified task 

$ACTRM - Removes task from ATL 

$STPCT - Stops current task 

$STPTK - Stops specified task 

$RLPAR - Releases task partition 

$RLPR1 - Releases specified partition 

$NXTSK - Assigns next task to partition 

$FNDSP - Finds space in system controlled partitions 

$TSTCP - Tests if checkpoint should be initiated 

$ICHKP - Initiates checkpoint of specified task 

$CHKPT - Checkpoint task 

$LOADT - Puts task in loader queue 

$TSKRT - Requests task execution 

$MAPTK - Maps task address window 

SST Service Routines (SSTSR) 

• Contains routines to service Synchronous System Traps (SST) 

$EMSST - Non-RSX EMT instruction 

$ILINS - Illegal or reserved instruction 

$IOTRP - IOT instruction 

$SGFLT - Memory protect violation 

$TRACE - T-bit trap or BPT instruction 

$TRP04 - Odd address, Non-existent memory, etc. 

$SSTXT - Common SST exit routine 
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Time Dependent Scheduling (TDSCH) 

• Contains routines to handle time dependent scheduling 

• Entered from clock interrupt 

Updates system time and date 
Manages clock queue 
Checks for device timeouts 
Manages Round Robin scheduling 
Manages Executive level disk swapping 

System Initialization (INITL) 

• Executes only for system which has not been saved 

Contains the Executive transfer address location ($INITL) 

• Performs system initialization functions 

Writes load device and image file information into SYSCM 

Initializes Processor Status Word 

Initializes Memory Management registers (Mapped system) 

Turns on memory management hardware (Mapped system) 

Initializes Unibus Mapping Registers (11/44, 11/70) 

Calculates size of physical memory 

Verifies the existence of the external directive commons 

Verifies the presence of the floating point processor 

Verifies the presence of EIS 

Verifies that all selected devices are online 

Verifies the presence of the watchdog timer 

Sets up system clock 

• Deallocates its space to DSR 

• Values initialized by INITL are written to system image by SAV 
task 
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Table 3-1 Executive Modules by Function 
Function Modules 

Scheduling 

Task Scheduling TDSCH - Time-Dependent Scheduling 

SYSXT - Normal Scheduling 

Round Robin Scheduling TDSCH 

Disk-Swapping TDSCH 

Idle Loop SYSXT 

Interrupt Processing 

Clock Interrupts TDSCH 

I/O Interrupts XXDRV - 'XX 1 Indicates Device 

System Entrance SYSXT 

System Exit SYSXT 

Trap Processing 
Synchronous System Traps SSTSR 

'EMT' Traps DRSUB 

DRDSP 

■TRAP' Traps DRSUB 

DRDSP 

System Entrance SYSXT 

System Exit SYSXT 

Context Switching SYSXT 

Data Movement BFCTL 
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Table 3-1 Executive Modules by Function (Cont) 

Function Modules 

DSR Allocation 

For Clock Queue CORAL 

For FIFO Queues CORAL 

For Priority Queues CORAL 

For CLI Messages CORAL 

For Error Messages ERROR 

Error Logging ERROR 

I/O Processing 

I/O Parameter Block IOSUB 

UMR Allocation IOSUB 

I/O Completion IOSUB 
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DIRECTIVE MODULES 

Resident Directive Module (DRSUB) 

• Contains entry points for routines entered by system traps 

STRTRP - Handles TRAP instruction 
$EMTRP - Handles EMT instruction 

• Contains commonly used routines 

$ELGEF - Eliminates Group Global Event Flag block 
$DEAGF - Deaccesses group global event flags 
$DRDSE - Declares significant event 
$DRWSE - Waits for significant event 
$MPXC1 - Maps the first directive common 
$MPXC2 - Maps the second directive common 
$DRQRQ - Queues an I/O request and calls driver 
$GTUCB - Gets UCB address for given device and unit 
$0THR1 - Calls directive routine in second directive 
common 

Directive Dispatcher (DRDSP) 

• Contains code to process EMT traps 

• Determines if EMT is 

Directive call 
Switch to Kernel mode 
Non-RSX EMT instruction 

• Contains table defining directives in system 
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Table 3-2 Directive Processing Modules 

Entry Module Punction 

ABRT$ $DRABO DRABO Abort Task 

ALTP$ $DRAP1 DRATP Alter Priority 

ALUN$ $DRASG DRASG Assign LUN 

ASTX$S $DRAXT DRATX AST Service Exit 

ATRG$ $DRATR DRREG Attach Region 

CINT$ $DRCIN DRCIN Connect to Interrupt Vector 

CLEF$ $DRCEF DRSED Clear Event Flag 

CMKT$ $DRCMS DRCMT Cancel Mark Time Requests 

CNCT$ $DRCNC DRSPW Connect 

CRAW$ $DRCRW DRMAP Create Address Window 

CRGF$ $DRCRE DRGEF Create Group Global Event Flags 

CRRG$ $DRCRR DRREG Create Region 

CSRQ$ $DRCSR DRCMT Cancel Time Based Requests 

DECL$S $DRDSE DRSUB Declare Significant Event 

DSAR$S $DRDAR DRDAR Disable AST Recognition 

DSCP$S $DRDCP DRDCP Disable Checkpointing 

DTRG$ $DRDTR DRREG Detach Region 

ELAW$ $DRELW DRMAP Eliminate Address Window 

ELGF$ $DRELE DRGEF Eliminate Group Global Event Flags 

EMST$ $DREMS DRSPW Emit Status 

ENAR$S $DREAR DRDAR Enable AST Recognition 

ENCP$S $DRECP DRDCP Enable Checkpointing 

EXIF$ $DREIF DREIF Exit If 

EXIT$S $DREXT DREIF Task Exit 

EXST$ $DREXS DRSPW Exit With Status 

EXTK$ $DREXP DREXP Extend Task 

GCCI$ $DRGCL DRGCL Get command for command 

GCII$ $DRCLI DRCLI Get command interpreter 

GLUN$ $DRGLI DRGLI Get LUN Information 

GMCR$ $DRGCL DRGCL Get MCR Command Line 

GMCX$ $DRGMX DRMAP Get Mapping Context 

GPRT$ $DRGPP DRGPP Get Partition Parameters 

GREG$ $DRGPP DRGPP Get Region Parameters 

GSSW$S $DRGSS DRGSS Get Sense Switches 

GTIM$ $DRGTP DRGTP Get Time Parameters 

GTSK$ $DRGTK DRGTK Get Task Parameters 

MAP$ $DRMAP DRMAP Map Address Window 

MRKT$ $DRMKT DRMKT Mark Time 

QIO$ $DRQIO DRQIO Queue I/O Request 

QIOW$ $DRQIO DRQIO Queue I/O Request and Wait 

RCST$ $DRRCS DRRAS Receive Data or Stop 

RCVD$ $DRREC DRRAS Receive Data 

RCVX$ $DRREC DRRAS Receive Data or Exit 

RDAF$ $DRRAF DRRES Read All Event Flags 

RDXF$ $DRRAF DRRES Read Extended Event Flags 



interpreter 
information 
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Table 3-2 Directive Processing Modules (Cont) 



Entry 



Nodule Function 



RPOI$ 


$DRREQ 


DRSPW 


RQST$ 


$DRREQ 


DRSPW 


RREF$ 


$DRRRF 


DRMAP 


RSUM$ 


$DRRES 


DRRES 


RUN$ 


$DRRUN 


DRMKT 


SCAA$ 


$DRCLI 


DRCLI 


SCLI$ 


$DRCLI 


DRCLI 


SDAT$ 


$DRSND 


DRRAS 


SDRC$ 


$DRSRC 


DRSPW 


SDRP$ 


$DRSRC 


DRSPW 


SETF$ 


$DRSEF 


DRSED 


SFPA$ 


$DRFEX 


DRPUT 


SMSG$ 


$DRSMG 


DRSMG 


SPND$S 


$DRSPN 


DRRES 


SPRA$ 


$DRPUT 


DRPUT 


SPWN$ 


$DRREQ 


DRSPW 


SRDA$ 


$DRRCV 


DRPUT 


SREA$ 


$DRREX 


DRPUT 


SREF$ 


$DRSRF 


DRMAP 


SRRA$ 


$DRRRA 


DRPUT 


STLO$ 


$DRSTL 


DRSED 


STOP$S 


$DRSTP 


DRRES 


STSE$ 


$DRSTS 


DRSED 


SVDB$ 


$DRSDV 


DRSST 


SVTK$ 


$DRSTV 


DRSST 


ULGF$ 


$DRELE 


DRCMT 


UMAP$ 


$DRUNM 


DRMAP 


USTP$ 


$DRUNS 


DRRES 


WSIG$S 


$DRWSE 


DRSUB 


WTLO$ 


$DRWFL 


DRSED 


WTSE$ 


$DRWFS 


DRSED 



Request and pass offspring information 

Request Task 

Receive By Reference 

Resume Task 

Run Task 

Specify command arrival AST 

Set command line interpreter 

Send Data 

Send, Request, and Connect 

Send data request and pass offspring 

control block 

Set Event Flag 

Specify Floating Point AST 

Send message 

Suspend 

Specify Power Recovery AST 

Spawn 

Specify Receive Data AST 

Specify Requested Exit AST 

Send By Reference 

Specify Receive-By-Ref erence AST 

Stop for Logical OR of Event Flags 

Stop 

Stop for Single Event Flag 

Specify SST Vector Table for Debugging 

Specify SST Vector Table for Task 

Unlock group global event flags 

Unmap Address Window 

Unstop Task 

Wait for Significant Event 

Wait for Logical OR of Event Flags 

Wait for Single Event Flag 
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DEVICE DRIVER MODULES 

System Device Tables (SYSTB) 

• Contains DCBs, UCBs and SCBs, for devices with resident data 
bases. 

• Data bases for standard drivers are contained in SYSTB. 

• User can include other device data bases in SYSTB at SYSGEN. 

RK05 Driver (DKDRV) 

• Device driver for RK05 disk drives. 

• Contains code for performing I/O to device. 

• Interrupts from RK05 drive cause entry into DKDRV at $DKINT 
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Table 3-3 
Driver 
DKDRV 
DMDRV 
DBDRV 
DRDRV 
DLDRV 
LPDRV 
TTDRV 
MMDRV 
MTDRV 
MSDRV 
DTDRV 
DXDRV 
DYDRV 
DDDRV 
DSDRV 
PPDRV 
PRDRV 
CTDRV 
DFDRV 
DPDRV 
LKDRV 



Standard Device Drivers 
Device 

RK05 Disk Drives 
RK06,RK07 Disk Drives 
RP04,RP05,RP06 Disk Drives 
RM02,RM03,RM05,RP07,RM80 Disk Drives 
RL01,RL02 Disk Drives 
Line Printer 
Terminal 

TU16,TE16,TU45,TU77 Magnetic Tape 
TU10,TE10,TS03,TM11 Magnetic Tape 
TS04 Magnetic Tape 
TC11 DECtape 
RX01 Floppy Disk Drive 
RX02 Floppy Disk Drive 
TU58 Disk Cartridge 
RS03 f RS04 Disk Drives 
Paper Tape Punch 
Paper Tape Reader 
TA11 Cassette Tape 
RS08 Fixed Head Disk Drive 
RP02 Disk Drive 
KMC-11 Line Printer, Controller 
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FILE SYSTEM OVERVIEW 



INTRODUCTION 

This module introduces the FILES-11 system. FILES-11 
consists of an on-disk and in-memory data structure. The on-disk 
is the same for a number of related operating systems (i.e., IAS, 
RSX-11D, etc.). The in-memory structure is RSX-11M specific' 
Tnis structure is a cache of information which improves the 
performance of the file system. 



OBJECTIVES 

1. Describe the on-disk and in-memory structures of the FILES- n 
system. 

2. Describe the directory structure used in FILES-11. 

3. Describe how files are accessed on a FILES-11 volume. 



RESOURCES 

1 ' RSX-llM/M-Plus I/O Operations Reference Manual 
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CONCEPTS 

FILES- 11 

• Method of organizing data on mass-storage media 

• Common to: RSX-11M/M-PLUS, RSX-11D, IAS, TRAX, VMS 

File system includes: 

• File processing software such as FCS or RMS 

Provides easy interface between user program and file 
system 

Allows access data by means of user-defined records 

• Executive code to handle queued I/O requests 

Result of QIO directive 

Provides synchronization of I/O operations 

Determines if i/o operation is file-oriented 

• A device driver to handle primitive I/O operations 

Data transfers between the device and memory 

• An ancillary control processor, ACP, which performs 
file-related I/O operations 

Possible conversion to driver operations 

A FILES-11 volume may be: 

• Any kind of disk (including floppy disks) 

• DECtape 
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PRIVILEGED 




QIO 
DIRECTIVE 



NON-PRIVILEGED 



FCS/RMS 



USER I/O 
REQUEST 



DEVICE- 
INDEPENDENT 



QIO 
DIRECTIVE 



DEVICE- 
DEPENDENT 



USER STATE__ 
SYSTEM STATE 



QIO 

DIRECTIVE 

SERVICE 



EXECUTIVE 

I/O 

SUBROUTINES 



DEVICE INTERRUPT- 



■T 



I/O 
DRIVER 



Figure 4-1 The File System 
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Files 

Three units of measurement of space on media: 

• Physical blocks 

Physically addressable unit 

Length dependent on type of media 

Usually 512 bytes 

RX01 - 128 bytes 

RX02 - 128 or 256 bytes 

Normally referenced by device driver 

• Logical blocks 

Length equal to 512 bytes 
Block numbers unique for volume 

Begins at logical block 

Highest logical block equals volume size minus one 
Normally referenced by the file processor (F11ACP) 

• Virtual blocks 

Used by programmer to access data in files 

Length always equal to 512 bytes 

Virtual block numbers relative to file 
Begins at virtual block 1 
Highest virtual block equals file size 
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Files consist of two parts: 

• The File Header 

• The File Body 

The File Header 

• Contains description of file 

> 

File name 

File owner 

File characteristics used by FCS and RMS 

Information for mapping virtual blocks to logical blocks 

• Usually one block long (512. bytes) ; size depends on the 
file processor in use 

The File Body 

• Contains data stored by user and any control data appended by 
the file access method 

• Consists of a number of contiguous groups of logical blocks 
(segments) 
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r 



(DISK 

BLOCK 

256 WORDS) 






V 



FILE HEADER BLOCK 



OFFSETS TO IDENTIFICATION 

AND MAP AREAS 
FILE ID 

FILE OWNERSHIP AND PROTECTION 
INFORMATION 

FILE CHARACTERISTICS 

SIZE (BYTES) OF HEADER AREA 



FILE NAME, TYPE AND VERSION 

DATES OF CREATION AND 
REVISION 

SIZE (BYTES) OF IDENTIFICATION 
AREA 



MAPPING INFORMATION 
RETRIEVAL POINTERS 
CHECKSUM WORD 




HEADER AREA 




IDENTIFICATION AREA 




MAP AREA 



Figure 4-2 The File Header 
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Dump of DB2:C305*306:iINTR0i.M0D*26 



File ID 7450*60*0 
File header 



HEADER AREA 








H.IDOF 






027 


H.MPOF 






056 


H.FNUM* 








H.FSEQ 






(7450*60) 


H.FL.EV 






401 


H.FOUN 






C 305* 3 06 1 


H.FF'RO 






CRUED*RWED*RUED*R.T 


H.UCHA 






000 = 


H . SCHA 






000 = 


H.UFAT 










F 


.RTYP 


002 = RA'AR 




F 


.RATT 


002 = FD.CR 




F 


.RSIZ 


102 = 66, 




F 


.HIBK 


HtO Li 000013 = 11. 




F 


.EFBK 


HJO Lt000013 = 11. 




F 


.FFBY 


310 = 200. 




(REST) 






000000 


000000 000000 000000 000000 000000 000000 000000 




000000 




IDENTIFICATION 


AREA 




I.FNAM* 








I.FTYP* 








I.FVER 






INTR01 .MOD* 26 


I.RVNO 






6 


I.RVDT 






14 -DEC-SI 


I.RVTI 






02J50J22 


I.CRDT 






15-0CT-81 


I. CRT I 






09 J 46: 39 


I.EXDT 






...._ 


MAP AREA 








M.ESQN 






000 


M . ERVN 






000 


M.EFNU* 








M.EFSG 






(0*0) 


M.CTSZ 






001 


M.LBSZ 






003 


M » USE 






002 ~ 2. 


H.MAX 






314 = 204. 


M , RTRU 








SIZE 


LBN 




.1. .1. . 


Hi 


!001 L 


.: 165751 = 125929. 


CHECKSUM 








H , CKSM 






123624 


Exampl 


.e 


4-1 


The File Header for a Data File 
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Dump of DB2JC305»3063SPY.TSKJ16 



r ile I'D 16104y7»0 
File header 



HEADER AREA 

H.IDOF 

H * MPOF 

H . FNUH > 

H.FSEC) 

H.FLEM 

H.FOWN 

H.FPRO 

H . UCHA 

H.SCHA 

H.UFAT 



027 
056 

<16104f7) 

40.1. 

C305, 306.1 

r RWED y RUED ? RWED » R 



200 
000 



UC.CON 



R.FIX 



IDENTIFICATION AREA 
I.FNAMy 
I.FTYP» 
I.FVER 
I.RVNO 
I.RVDT 

l'.RVTI 

I . CRDT 

I. CRT I 

I.EXDT 
MAP AREA 

M.ESGN 

M.ERVN 

M . EFNU , 

M.EFSG 

M.CTSZ 

M.LBSZ 

M.USE 

M.MAX 

M.RTRV 

SIZE LBN 

40* HfOOl 
CHECKSUM 

H.CKSM 



F.RTYP 
F.RATT 
F.RSIZ 

F.HIBK 
F.EFBK 
F.FFBY 
(REST) 

000000 000000 000000 000000 000000 000000 000000 000000 
000000 



001 

000 = 

1000 = 512. 

h:o l: ooooso 
hio l: 000051 
= 0. 



40. 
41. 



SI 

s 



SPY 

■'.>■'? 

14-DEC 
02 J 50 J 
05-JUN -81 
14S14J33 



000 
000 

( .. ) 
001 
003 
002 = 
314 = 



.TSK?16 



?04. 



LM. 72544 



133671 



128356. 



Example 4-2 The File Header for a Task Image 
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Retrieval Pointers 

• Defines the correspondence between logical and virtual blocks 

• Contained in the file header: 

Maximum: 102 per header 

One fragment per retrieval pointer 

Maximum file length with 1 block per header: 26112 blocks 

• Four bytes long 

One byte: number of virtual blocks in segment; maximum 
is 256 blocks. 

Three bytes: pointer to first logical block in segment. 



NO. BLOCKS - 1 



STARTING LBN 



(1,3) RETRIEVAL POINTER 



Figure 4-3 Retrieval Pointer 
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FILE HEADER 







VBN 


FILE BODY 


LBN 




f 2 




301 




r 






406 


±^ 


3 




302 


RETRIEVAL 


1 


^^L , i 




POINTERS^ 


301 


^k 











^ 




406 




<. 701 














^"^ 4 




701 



Figure 4-4 Mapping Virtual to Logical Blocks 
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File Directories 

• Contains information needed to identify and locate files 

File name, type and version number 

File number (Relative number of file headers in index 
file) 

File sequence number (Number of times a file header is 
used) 

• Two types of directories 

Master File Directory (MFD) — One per volume 

User File Directory (UFD) — As many as desired per volume 



Naming convention 

Name of directory: xxxyyy.DIR;! 

where 

xxx is a group number 
yyy is a member number 

Master File Directory: 000000. DIR;1 

User File Directory for UIC: [6,32]: 



006032. DIR;1 



1 

2 
3 
4 
5 
6 
7 
8 



FILE ID 



FILE SEQUENCE NO. 



FILENAME 
(RAD50) 



FILE TYPE (RAD50) 



FILE VERSION 



Figure 4-5 Directory Record 
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FILES- 11 VOLUMES 
The Standard Files 

• The Index File: INDEXF.SYS 

• The Bitmap File: BITMAP. SYS 

• The Master File Directory: 000000. DIR 

• The Bad Block File: BADBLK.SYS 

• The System Checkpoint File: CORIMG.SYS 
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The Index File 

• Contains basic structures needed by file system. 

Boot Block 
Home Block 
Index File Bitmap 
All File Headers 

• Filespec: [0 , 0] INDEXF.SYS; 1 , 
File ID/SEQ: 1/1 

• Boot Block 

Contains bootstrap code for hardware booting of device 

Always virtual block 1 of index file 

Always logical block of volume 

Written by SAV command when the /WB switch is used 

If volume not bootable, contains code to print the 
message: THIS VOLUME DOES NOT CONTAIN A HARDWARE BOOTABLE 
SYSTEM 

• Home Block 

Contains information needed by file system to access data 
on volume 

Volume label 

Pointer to index file bitmap 

Size of index file bitmap 

Checksum words to validate data in home block 

Always located in virtual block 2 of index file 

Located in first good block in sequence 
1, 400, 1000, 1400, 

Checksum used to identify homeblock 
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• Index File Bitmap 

Allows fast access to unused blocks in index file 

Always located beginning in virtual block 3 of index file 

One bit per possible file header in index file 

Bit is set to indicate if block is in use 

Bit clear if block is free 

Bit is set if block is in use 

• File Headers 

Contained in virtual blocks starting at block 3+n, where n 
is the length of the bitmap 

First 16 headers are contiguous 
Virtual block of header = 2 + m + n 
where 



n - number of blocks in index file bitmap 
m = file number 
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VBN 
1 



3+N 
4+N 
5+N 
6+N 
7+N 

8+N 



BOOT BLOCK 



HOME BLOCK 



INDEX BIT MAP 
0=FREE 
1=USED 



INDEX 
FILE HEADER 



STORAGE BIT MAP 
FILE HEADER 



BAD BLOCK 
FILE HEADER 



LBN 




1 OR 400 OR 1000... 



MASTER FILE DIRECTORY 
FILE HEADER 



CORE IMAGE CHECKPOINT 
FILE HEADER 



N IS SIZE OF INDEX 
BITMAP (NO. BLOCKS) 



USER FILE DIRECTORY 
FILE HEADER 






Figure 4-6 Structure of the Index File 
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The Bitmap File 

• H rt " al block number 1 contains allocation information used on 
RSX - "1 ID 

• Bitmap starts in virtual block number 2 of the bitmap file 

• One bit per logical block on volume 

• Value of each bit indicates status of corresponding block 

Bit set - block not allocated to file 
Bit clear - block allocated 

• VFY compares clear bits with retrieval pointers 

• Filespec: [0,0] BITMAP. SYS; 1, 
File ID/SEQ: 2/2 



WORDO 



WORD 1 



15 






15 



t 



LBN 15 



t 



LBNO 



LBN 31 

Figure 4-7 The Bitmap File 



LBN 16 
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The Master File Directory 

Directory corresponding to UFD [0,0] 

Contains entries for the five standard files 

Contains entries for all UFDs on volume 

Contains entry for system account file RSX11.SYS 

Filespec: [0 , 0] 000000. DIR; 1 , 
File ID/SEQ: 4/4 



The Badblock File 

• Used to keep bad blocks from being allocated to user files 

• Bad block information created by BAD or entered by the user or 
manufacturer allocates blocks to file 

• Filespec: [ 0, 0] BADBLK. SYS ; 1 , File ID/SEQ: 3/3 

• No dynamic badblock handling 



INDEXF 
SYS 



BITMAP 
SYS 



BADBLK 
SYS 




000000 
DIR 



CORIMG 
SYS 



GGGMMM 
DIR 



FILE MAC 



FILE OBJ 



FILE TSK 



XXXXXX 
DIR 



J 



••• 



Figure 4-8 Two Level Directory Structure 
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The System Checkpoint File 

• Used to checkpoint tasks 

• No space allocated when volume initialized 

• Space allocated by ACS command 

• Always contiguous 

• Filespec: [0, 0] CORIMG. SYS;1 , 
File ID/SEQ: 5/5 
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FUNCTIONS OF THE FILE SYSTEM 
Creating a FILES- 11 Volume 

• FILES-ll volume created by INITIALIZE command 

• Home block information can be modified by the HOME command 

• Creates five standard files 

• Volume characteristics determined: 

Volume label 

Number of blocks for default file extension 

Size of index file (number of blocks used for file 
headers) 

Number of files on volume 

Location of index file 

Default protection for files on volume 
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Creating a File 

• Index file bitmap searched for first free block 

• First free block used for file header 

• Bitmap file searched for required number of free blocks to 
allocate initial file 

• Entry for new file placed in UFD 



CREATE 

FILE 
HEADER 




USE INDEX 

FILE BITMAP 

TO ALLOCATE 

HEADER 



T 



INITIALIZE 
FILE HEADER 



CREATE 

DIRECTORY 

ENTRY 




ENTER FILE 

NAME INTO 

UFD 



I 



SET UP FILE 

ID IN 

HEADER 



ALLOCATE 
BLOCKS TO 
FILE BODY 




USE BITMAP 

FILE TO 

LOCATE UNUSED 

BLOCKS 



MAP VIRTUAL 

TO LOGICAL 

BLOCKS 




INITIALIZE 
RETRIEVAL 
POINTERS 



Figure 4-9 Creating a File 
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Accessing a File 

• By file name - DB1: [101, 101] DATA. DAT; 1 

MFD from device mounted on DB1: is searched for 
101101. DIR 

File ID for 101101. DIR is used to find the file header 

Retrieval pointers from header are used find UFD file 

UFD is searched for entry for DATA. DAT 

File ID for DATA. DAT is used to find the file header 

Retrieval pointers from header are used to find file 

File is accessed 



If file ID is known, file header can be accessed without using 
directories 



VBN 



INDEX FILE 



INDEX FILE HEADER 



13 



BITMAP FILE HEADER 



6 BADBLOCK FILE HEADER 



MFD FILE HEADER 



10 CORIMG FILE HEADER 



11 UFD L1,1] HEADER 



12 UFD [200,200] HEADER 



UFD [101,101] HEADER 



14 DATA.DAT;1 HEADER 



MFD 



ID.SEQ.O 



INDEXF.SYS;1 


1,1,0 


BITMAP.SYS;1 


2,2,0 


BADBLK.SYS;1 


3,3,0 


000000. DIR ;1 


4,4,0 


CORIMG. DIR;1 


5,5,0 


001001. DIR;1 


6,1,0 


200200.DIR;1 


7,1,0 


005006.DIR;1 


0,3,0 


101101.DIR;! 


10,6,0 



UFD [101,101] 



A.FTN;1 
DATA.DAT;1 



0,5,0 
11,1,0 



DATA.DAT;1 



USER FILE DATA 



Figure 4-10 Accessing a File 
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THE FILE PROCESSOR 
File Control Processors 

• Privileged system task which handles file-specific I/O 

• Processes QIO commands queued to its receive queue 

• Several file processors supplied with system 

F11ACP - Used for FILES-11 disk volumes 
MTAACP - Used for magnetic tape volumes 
NETACP - Used by DECNET 

• To speed up file operations, dedicate appropriate FCPxxn to 
volumes 

>INS $FCPxxx/TASK=DBlFCP 
>MOU DK0:/ACP=DB1FCP 
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Logical Units 

• Tasks specify I/O devices by using logical unit numbers. 

• Each logical unit number refers to a unique I/O device. 

• Pointer to an entry of the logical unit table for the task. 

• The logical unit table is in the task header. 

• Each entry is two words long: 

Word one is a pointer to the UCB for the device: 

Word two is a pointer to a FILES-11 window block if file 
is open; and otherwise. 

• FILES-11 window block is a data structure used to store 
retrieval pointers. 

• Logical unit table constructed and units assigned at 
taskbuild . 

• Logical unit assignments can be changed by: 

REASSIGN command 
ALUN$ directive 
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LUN 1 
LUN 2 
LUN 3 
LUN 4 
LUN 5 
LUN 6 



{ 



TASK HEADER 



NUMBER OF LUNs = 6 



POINTER TO UCB 

POINTER TO WINDOW BLOCK IF F7LE~OP~iN~ 



"\ 



POINTERJOUCB 

POINTER TO WINDOW BLOCK IF f7lE~OPEN 



- 






LOGICAL 

UNIT 

TABLE 



J 



Figure 4-11 The Logical Unit Table 
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Data Structures 

• The Volume Control Block (VCB) 

Created from information in home block 

One VCB per mounted volume 

Contains 

Transaction count for volume 
Logical block number of index file bitmap 
Logical block number of storage bitmap 
Pointers to other data structures, e.g. FCB 

• The File Control Block (FCB) 

Created from file header 

One FCB per open file 

Contains 

Logical block number of file header 
File number and sequence numbers 
File owner and protection code 

• FILES-11 Window Block 

One window block per accessor to file 

Contains 

Access privileges of accessor 
Retrieval pointers (seven by default) 



NOTE 
Retrieval pointers in the file header use one 
byte for the block count and three bytes for 
the disk address; those in the window block 
use two bytes for the count and four bytes 
for the disk address. 
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Figure 4-12 The Volume Control Block 
(Part One) 
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Figure 4-12 The Volume Control Block 
(Part Two) 
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Figure 4-13 The File Control Block 
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Figure 4-14 FILES-11 Window Block 
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Mounting a Volume 

• Volume mounted by MOUNT command 

Compares the volume label with that specified in the MOUNT 
command 

Copies homeblock information into VCB 

Associates an ACP with the volume 



• Steps in mounting a FILES-11 volume: 
Volume Control Block is created 
VCB is linked from the UCB using U.VCB 
Index file is opened 



IN MEMORY 



ON DISK 



INDEX FILE 
WINDOW 




XXXACP 



Figure 4-15 Mounting a Volume 
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Opening a File 

• Steps in opening a file: 

File Control Block or FCB is created. 

FILES-11 window block is created for file. 

FCB is inserted in the FCB queue for volume. 

Pointer from logical unit table to window block is 
initialized . 

• Shared files have only one FCB but separate window blocks. 

• File system keeps, in memory, a list of FCBs of the more 
recently used directories. 

This list is called the LRU. 

Eliminates need to read directories from disk when file is 
accessed . 

Least recently used directory is flushed when new 
directory accessed if list is full. 

Size of LRU list is determined by LRU switch on INI or HOM 
command . 
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Figure 4-16 Opening a File 
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Figure 4-17 Shared Access 
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SYSTEM GENERATION 



INTRODUCTION 

The RSX-11M operating system is designed to support a large 
variety of application environments and possible hardware 
configurations available to the PDP-11 processor. The process 
used to adapt the system to these varied conditions is called 
System Generation or SYSGEN. 

The RSX-11M SYSGEN procedure is designed to allow customizing 
of the operating system to be performed in an efficient and 
accurate manner. The procedure is run under the control of 
supplied indirect command files. Facilities such as VMR and SAV 
are provided to help the user set up his system quickly. 



OBJECTIVES 

1. Generate a functioning RSX-11M system. 

2. Perform the ancillary functions, VMR and SAV, to produce a 
practical system. 



RESOURCES 

1 - RSX-11M System Generation and Management Guide 
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OVERVIEW 
SYSGEN Functions 

• Provide support for existing hardware 

The processor model (e.g., PDP-11/44) 

Processor options (e.g., memory management, floating-point 
processor) 

Devices installed on system 

Number of controllers and physical units 

Vector and CSR addresses for all devices 

• Provide needed software features 

Executive options (e.g., directives, 'round-robin') 
File system (version of F11ACP) 
Resident library support (e.g., FCPRES) 
Terminal support (e.g., full-duplex) 
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The SYSGEN Process 

• SYSGEN procedure is contained in three indirect command files 

SYSGEN.CMD - First phase of SYSGEN 

Assembles Executive 

Assembles device drivers 

Creates command files to be used in phase two 

SYSGEN2.CMD - Second phase of SYSGEN 

Taskbuilds the Executive 

Taskbuilds the device drivers 

Creates needed libraries 

Taskbuilds the privileged system tasks 



SYSGEN3.CMD - Third phase of SYSGEN 
Allows system tasks to be rebuilt 



• Between phase two and phase three, VMR should be applied to 
the new system 

Use VMR command file SYSVMR.CMD created by the SYSGEN 
procedure 

Can be edited to add desired partitions 
Must be edited if system is unmapped 

Configure the new system 

Set up partitions 
Load device drivers 
Install system tasks 



SYSGEN procedure creates saved answer file SYSSAVED.DAT 

Contains answers to SYSGEN questions in symbolic form 
File can be modified by user for use in later SYSGEN 
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Types of SYSGEN 

• SYSGEN can be performed using the base-line system on the 
distribution kit 

Called a standalone SYSGEN 

System is dedicated to SYSGEN, no other users 

• SYSGEN can be performed using an existing RSX-11M system 

Called an on-line SYSGEN 

Other users can use the system during most of the SYSGEN 
process 

• MCR commands can be inhibited during the SYSGEN process 

Called a PREPGEN 

Saved answer file can be corrected/modified for use later 
in live SYSGEN 
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New Features for Version 4.0 

• Autoconf igure option determines correct hardware configuration 

Processor type 

CSR and vector addresses 

• Standard feature Executive option produces a mapped system 

Most software options 
Supports all layered products 

• Improved saved answer file support 

Saves responses to Phase II questions 

Supports named input and output saved answer files 

Can create a single saved answer file for Phase I and II 

A minimum of 28K words of memory is required for SYSGEN 

Directive commons increase POOL size 

Taskbuild .CMD and .ODL files are dynamically created 

A PLAS overlaid FCS resident library may be selected 

Either EDI or EDT may be selected for editing SYSGEN files 

Phase I can chain to Phase II without a break 
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PREPARING FOR SYSGEN 
Distribution Kits 

• There are several different kits available 

'Big Disk' distribution kit for RP04/05/06/07, RM02/03/05, 
RM80 and RA80 

RK06/07 distribution kit 

RL01/02 distribution kit 

RK05 distribution kit 

• Distribution kit must be copied before SYSGEN using DSC 

Version 3.2 DSC cannot be used unless V 4.0 patch has been 
applied (see release notes) 

Copy of standalone DSC supplied with kit can be used 

Autopatch 

• A collection of patches to the released system 

Issued at regular intervals 

Also may include patches to layered products 

• Must always be applied to released version without previous 
patches 

• Uses an indirect command file to generate patched system 
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Individual Patches 

• Patching source files 

Used for Executive, driver and MCR patches 

Use Source Language Input Program (SLP) 

Create SLP command file 
Invoke SLP with command file 

For MACRO-11 sources, output for SLP must be: 

Assembled 

Task-built 

Integrated into system (Method depends on component 

patched) 

Patching object files 

Used for patching utilities 

Use Object Module Patch Utility (PAT) 

Create MACRO-11 source file for correction 

Assemble correction file 

Apply correction to old object file using PAT 

Output from PAT must be: 

Task-built 

Reinstalled into the system 

• Patching task image files 

Infrequently used for operating system patches 

Frequently used for patching layered products 

Use Task/File Patch Program (ZAP) 

Create ZAP command file 

Invoke ZAP to apply patches to task image file 

• Patches supplied by DIGITAL are cumulative 

Apply a patch only if you have already applied all 
previous patches 

Unless the patch states otherwise, apply patch to most 
recent version of the component 
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DETAILS OF SYSGEN 
Phase 1 

There are seven sections in Phase 1 

Setup - How SYSGEN is to be run 

Target Configuration - The environment for which the 

SYSGEN is being performed 

Host Configuration - The system on which SYSGEN is 

being run 

Executive Options - What features are desired in the new 

system 

Terminal Driver - Which type of terminal driver and which 

features are desired 

System Options - Which file processor, CLI support, and 

POOL monitoring support is desired 

Peripheral Options - Specification of devices, controllers 

and their vectors, and CSRs 

After questions have been answered, the Executive and drivers 
are assembled 
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Phase 2 

There are eight sections in Phase 2 

Setup - How SYSGEN Phase 2 is to be run 

Library Commons Creation - Modifies SYSLIB, creates other 

libraries used in taskbuilding 
system tasks 

Executive Taskbuild - Creates system images RSX11M.TSK, 

EXC0M1.TSK and EXC0M2.TSK 

System Image Creation - Creates RSX11M.SYS from RSX11M.TSK 

Full-Duplex Terminal Driver Taskbuild - Creates the full- 
duplex driver if 
selected 

Loadable Driver Taskbuild - Creates all drivers not built 

into the Executive 

Privileged Task Taskbuild - Builds privileged system tasks 

System VMR - Modifies RSX11M.SYS, creating partitions, 
installing tasks, etc. 



114 



SYSTEM GENERATION 



Phase 3 

• Optional - May be performed when and as often as desired 

• Used to build optional tasks not included in distribution kit 

• Used to rebuild supplied tasks to: 

Change defaults 

Incorporate support for ANSI magtape and/or FCS 
big-buffering 

Use a resident FCS library 

• Used to rebuild tasks after patching 

• VMR must be used to remove and install new versions of tasks 
installed in the system image 
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EXECUTIVE OPTIONS 

Standard Feature Executive 

• Allows the generation of 
features 

• Requires a mapped system 

• Provides the following: 



DBMS-11 support 

FILES-11 ACP support 

RMS support 

Nonresident task support 

Loadable task loader 

Directive commons 

Memory management directives 

All other Executive directives 

Address checking support 

I/O rundown support 

Multiuser support 

ANSI Magtape support 

Loadable driver support 

AST support 

20K word Executive 

Error logging 

Powerfail recovery 

User written driver support 

System controlled partitions 

Round-robin scheduler and disk swapping 

Software write lock support 

Queue manager 

Shuffler 

Crash dump support 

Full-duplex terminal driver 

DCL and two user written CLIs 

POOL monitoring 

PLAS resident FCS 

'MIDDLE' F11ACP 



a system supporting all standard 
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The Terminal Driver 

• Two possible terminal drivers: 

Half-duplex driver 
Full-duplex driver 

• Half-duplex driver comes in three forms: 

Baseline 
Tailored 
Tailorable 

• The baseline half-duplex driver 

Minimum terminal driver 

Not available with multiuser systems 

• The tailored half-duplex driver features include: 

Automatic carriage/line feed 

Write with CTRL/0 cancellation 

Breakthrough write 

CTRL/R rewrite 

Get multiple characteristics 

Get terminal driver options 

Read after prompt 

Read with no echo 

Read with special terminator 

CRT rubout support 

User terminal input buffering 

• The tailorable driver allows selection of all possible 
terminal options 

• The full-duplex driver includes: 

Task checkpoint during input 

Passes form feeds directly to the terminal 

Supports unsolicited input character AST (requires 

Executive AST support) 

Hold screen mode 

LA30P support 

Device independent cursor positioning 

Plus features included in the tailored half-duplex driver 



• 



Full-duplex driver requires a mapped system with loadable 
driver support 
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Choosing a File Processor 

• Several different versions of F11ACP available 

• Versions differ in amount of overlaying and in number of 
internal buffers 

• See discussion in module 'I/O Processing' for descriptions of 
available ACPS 
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USING VMR 

Overview of VMR 

Can perform many of the same tasks as MCR 
Define partitions 
Load drivers 
Install tasks 



• 






Commands operate on system image file 

Used to perform system initialization for needed features 

Set up partitions 

Load standard drivers 

Install system tasks and utilities 
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On a Mapped System 

• SYSGEN generates a VMR command file which should be edited to 
produce the system desired 

• All needed partitions are defined 

Driver partition 

Directive commons 

All leftover space goes in GEN 

• Commands for partitions needed by application tasks must be 
added to the command file 

• All DEC-supplied drivers are loaded 

• All important system tasks are installed 
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EXECUTIVE 
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242700 
232600 

206200 
146200 
143400 
134500 
120000 



Figure 5-1 Partition Structure on Mapped Systems 
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On an Unmapped System 

• Modification of SYSVMR.CMD recommended on unmapped system 

It is not possible for SYSVMR.CMD to create an optimal 
partition structure 

• For unmapped 16K to 24K systems, VMR: 

Creates partition GEN and installs all tasks into it 
Length is always 40000 bytes 

Creates partition SYSPAR 

Length is 1000 bytes if FCPMIN chosen 
Length is 1200 bytes if FCPSML chosen 

Creates partition SPLPAR if PRT chosen 
Length is 10400 bytes 



• 



For unmapped 24K to 28K systems, VMR: 

Creates partition GEN and installs all tasks into it 
Length is always 40000 bytes 

Creates partition SYSPAR 

Length is 1000 bytes if FCPMIN chosen 
Length is 1200 bytes if FCPSML chosen 

Creates partition PAR14K 
Length is 70000 bytes 

Creates partition SPLPAR if PRT selected 
Length is 10400 bytes 
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Figure 5-2 Partition Structure on Unmapped 24K to 28K Systems 
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Figure 5-3 Partition Structure on Unmapped 16K to 24K Systems 
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SAVING THE NEW SYSTEM 

• Copies the current system image into the system image file 
from which the system was booted 

• Used to make a system hardware bootable 

• System must be saved before compressed by DSC or BRU 

• Requirements for saving a system 

SAV must run from CO: 

Error logging is not active 

All tasks are installed from LB: 

No checkpoint files are active 

No volumes are mounted except the load device 

The load device can be successfully dismounted 

No tasks have outstanding I/O 

No task is connected to interrupts 

All drivers, active tasks and fixed tasks reside within 
the saved area of memory 

• Saving a system 

Lowest part of memory copied into buffer in SAV task 
Secondary bootstrap program loaded into low memory 
Special driver used to load system to and from disk 

Cannot use interrupts 

Same special drivers used by SAV and BOOT 
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Can create a bootstrap program within the volume bootblock 

Reads in first block in system image file 

Transfers control to secondary bootstrap in block just 
loaded into memory 



Before writing system image to disk, converts logical 
block number in TCB into file ID 

When system booted, file IDs in TCBs converted back into 
logical block number 



SAVE 
TASK 
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STACK 



SPECIAL DRIVER 



2010 



Figure 5-4 Saved System Image 
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PHYSICAL AND VIRTUAL MEMORY 



INTRODUCTION 



The most important resource managed by an operating system is 
physical memory. To manage memory, an operating system must 
define subdivisions of memory, allocate space to tasks, and 
optimize memory use. This module examines the data structures 
used to perform these tasks. 

Since the PDP-11 uses 16-bit words, only 32K words of 
physical memory can be addressed unless some form of address 
relocation is provided. On the PDP-11, the KT-11 memory 
management hardware provides the mechanism for relocation. This 
module also explains the hardware and processing used. 



OBJECTIVES 

1. Diagram the data structures used by the Executive to control 
physical memory. 

2. List the steps in checkpointing a task. 

3. Describe the memory management hardware. 
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CONCEPTS 
Physical Addresses 

• A contiguous series of word addressable hardware locations 

• Defines main memory and peripheral device registers 

Virtual Addresses 

• Set of addresses used within a task 

• Program counter is a 16-bit register 

User task can reference addresses between and 177777 
octal 

Virtual addresses are local to a task 



Unmapped Systems 



32K words of addressing space 
Maximum physical memory is 28K words 
Programs built for specific memory location 
• No memory protection 
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Figure 6-1 Typical Unmapped System 
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Mapped Systems 

• KT-ll hardware is present 
Two types of mapped systems 



• 



• 



18-bit addresses 

128K words of addressing space 
124K words of physical memory 

22-bit addresses 

2048K words of addressing space 
1920K words of physical memory 

16-bit virtual address converted to 18- or 22-bit physical 
addresses 

Virtual addresses range from to 32767 

Relocation and memory protection provided 
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Figure 6-2 Typical Mapped System with 18-bit Addressing 
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Figure 6-3 Typical Mapped System with 22-bit Addressing 
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MEMORY MANAGEMENT 
Overview 

• Basic functions 

Perform memory relocation/mapping 

Provide extended memory addressing capability 

• Task is mapped in pages 

Page length is from 1 to 128 memory blocks 

Memory block is 32 words in length (100 octal bytes) 
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Memory Management Hardware 

• Several sets of relocation registers: Active Page Registers 

( APHS ) ~* 

• Each APR consists of two 16-bit words 

Page Address Register (PAR) 

Contains a physical memory address in units of 32 
words memory blocks 

Used to relocate 4K words of virtual memory (one page) 

Page Descriptor Register (PDR) 

Contains the size of the virtual memory block to be 

relocated 

Provides control of access rights 



• Every mapped system contains at least two sets of eiqht APRs 
KERNEL Mode APRS y 

USER Mode APRs 



• Larger processors have more APRs 

APRs for KERNEL and USER mode Instruction and Data space 
Supervisor mode Instruction and Data space APRs 

• The Processor Status Word (PS) determines the APRs in use 

• Four memory management registers (MMR0, MMR1, MMR2, and MMR3) 
control processor use of memory management 

MMR0 - Error flags 

Page number whose reference caused error 
Other status flags 

MMRl - Only on 11/44 and 11/70 

Records any autoincrement/decrement of 
general purpose registers 

MMR2 - The Virtual Address Program Counter 

MMR3 - Only on 11/44 and 11/70 
Enables/disables 

Use of D space APRs 
22-bit mapping 
UNIBUS mapping 
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Figure 6-4 Registers Used by Memory Management 
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Figure 6-6 Page Address Registers 
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Software Use of Memory Management 

• RSX-11M uses KERNEL and USER instruction space APRs 

• KERNEL APRs are loaded so that 

APRs through 3 or 4 point to Executive code and data 

4 APRs for 16K word Executives 

5 APRs for 20K word Executives 

APR 7 points to the I/O page 

Other APRs are dynamically mapped as needed 

• User tasks are mapped using USER APRs 

If task does not map to the Executive 

APRs are used consecutively starting at APR 

If task maps to the Executive 

APRs through 3 or 4 are the same as the KERNEL 

APRs through 3 or 4 

APR 7 points to the I/O page 

Other USER APRs are used to map the user task 
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Figure 6-7 Use of Memory Management by a Nonpr ivileged Task 
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Figure 6-8 Use of Memory Management by the Executive 
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Figure 6-9 Use of Memory Management by a Privileged Task 
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ALLOCATING PHYSICAL MEMORY 

Partitions 

Task Partitions 

• Controlled by user 

• May be divided into subpartitions 

• May be built to run in main partition or in one of the 
subpartitions 

• Controlled by busy word P. BUSY in the PCB of the main partiton 

Common Partitions 

• Used for shared data or code 

• Linked to task statically by taskbuilder or dynamically by 
using memory management directives 

Device Partitions 

• Pseudo-areas whose addresses overlay the I/O page 

• Allow nonprivileged tasks to access the I/O page 

System-Controlled Partitions 

• Used to hold executable tasks, device drivers, and dynamic 
regions 1 

• Space allocated as needed by the Executive 



• 



Tasks loaded into dynamically created subpartitions 
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Figure 6-10 Subpartitions of a Task Partition 
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The Partition Wait Queue 

• Linked list of TCBs of tasks waiting for space in partition 

• Ordered by descending task priority 

• When TCB is placed in wait queue of system controlled 
partition, subpartition PCB is created but not linked to 
partition list 

• First task in queue is allocated space before others 
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Figure 6-11 The Partition Wait Queue 
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USING PHYSICAL MEMORY 

Loading Tasks 

• Task TCB placed in loader queue after space allocated 
Loading performed by loader task, LOADR 

Loader task uses loader queue to decide which task to load 
next 

Utility link word, T.LNK, used to link TCBs in queue 
Location T.RCVL in the loader TCB is the queue listhead 

Steps in loading: 

Executive places TCB of task to be loaded in the loader 
queue (LOADRs receive queue) 

Executive unstops the loader 

Loader scans queue and loads task 

When queue is empty, loader calls $STPCT to stop itself 
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Checkpointing 

• Task is copied from memory to space on a disk volume 

Allows a higher priority task to execute 

Copied either to a reserved area in task image file or to 
a system checkpoint file 

Reserved area only used if system checkpoint files are 
full 

• Steps in checkpointing a task 

Test to see if task should be checkpointed 

Initiate the checkpoint operation 

Allocate checkpoint space and write the task to disk 
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Figure 6-12 Steps in Checkpointing a Task 
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Figure 6-13 System Checkpoint Files: The Checkpoint PCB 
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Figure 6-13 System Checkpoint Files: PCB Linkages 
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Shuffling 

• Consolidates holes in a system-controlled partition 

• Shuffling performed by shuffler task - SHUFL 

• Performed in two passes over a system-controlled partition 

Shuffler Pass One 

• Partition list searched, from $PARHD, for system-controlled 
partition 

• If task is in wait queue of system-controlled partition, 
shuffle operation is initiated 

• Shuffle operation: 

Find next hole (first?) 

Find region following hole 

Determine if region is shufflable 

If shufflable, checkpointable and stopped, or blocked by 
MCR BLOCK command, task is checkpointed 

If shufflable, move region and contents to bottom of hole 

When all regions have been shuffled, invoke $NXTSK to 
reallocate space 

• Nonshuf flable regions 

Loaded device drivers 

Tasks connected to interrupt vectors 

Tasks fixed for parity errors 

Tasks with long outstanding I/O (did not complete in 1/2 
second) 

Dynamic regions 

If nonshuf flable region is found, next hole is found and 
process continues 

• If pass one completes and the partition wait queue is not 
empty, pass two is invoked. 
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Shuffler Pass Two 

• Attempts to gain space by finding a contiguous sequence of 
holes and lower priority checkpointable tasks 

• Checkpoint operations initiated by calls to $ICHKP 

• When checkpointing is complete, pass one is rerun 
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Figure 6-14 Shuffling Tasks 
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USING VIRTUAL MEMORY 
Attaching 

• Makes region available to attaching task 

• Steps in attaching to a region: 

An Attachment Descriptor Block (ADB) is created 

ADB is linked to the PCB for the region using A.PCB in the 
ADB, and P. ATT in the PCB 

ADB is linked to the TCB for the task using A.TCB in the 
ADB, and T.ATT in the TCB 

ADB is linked into the ADB list for the partition using 
A.PCBL in the ADB 

ADB is linked into the ADB list for the task using A.TCBL 
in the ADB 
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AS.DEL - TASK HAS DELETE ACCESS (1=YES) 
AS.EXT - TASK HAS EXTEND ACCESS (1=YES) 
AS.WRT - TASK HAS WRITE ACCESS (1=YES) 
AS.RED - TASK HAS READ ACCESS (1=YES) 

ATTACHMENT DESCRIPTOR STATUS BITS 

Figure 6-15 The Attachment Descriptor Block 
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Figure 6-16 Attaching a Task to a Region 
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Mapping 



Task virtual address window block contains information needed 
to load APRs to allow access to physical region 

Task is mapped to a region if a window block contains the 
needed access information for the region 

Pointers to the PCB and ADB for the region 

High and low virtual address limits for the region 

Window size and offset in the physical region in 32 word 
blocks 

Number of APRS needed for the window and PDR information 
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Figure 6-17 Task Virtual Address Window Blocks 
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Figure 6-18 Mapping a Task Address Window to a Region 
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TASK MANAGEMENT 



INTRODUCTION 

The basic unit of executable code under RSX-11M is the task. 
Most tasks are user written, but some are system-supplied, such as 
the task-loader, MCR, etc. The Executive must manage the task 
scheduling and allocate needed resources to requesting tasks. 
This module describes the techniques used to manage tasks. 



OBJECTIVES 

1. Describe the content and functions of the task label blocks 
and task header. 

2. Diagram the data structures used to manage task scheduling. 

3. Describe the process of task termination. 



RESOURCES 



1. RSX-11M System List and Data Structures 

2. RSX-11M/M-PLUS Executive Reference Manual 
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THE TASK IMAGE 
The Task Image File 

• Created by the taskbuilder 

• Includes: label block group, checkpoint area (optional), task 
header, and task image 

The Label Block Group 

• Label block 

Task and resident library data 

Used to set up TCB and task addressing windows in header 

• Label block 1 

Table of LUN assignments for LUN 1 through LUN 128 
Used to create Logical Unit Table (LUT) in header 

• Label block 2 

Continuation of Table of LUN assignments for LUN 129 
through LUN 255 (if needed) 

Used to create LUT in header 

• Label block 3 

Segment load list (optional) 

Resident libraries that contain memory resident overlays 

The Checkpoint Area 

• Used to provide checkpoint space when no space available in 
the system checkpoint files 

• Size equal to size of header plus the task image 
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GROUP 
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TASK HEADER 



TASK IMAGE 
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(TASK-RESIDENT 
OVERLAY DATA BASE) 
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(CONTIGUOUS BLOCKS) 



SEGMENT TABLE 
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Fiqure 7-1 Task Image File 
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The Task Header 

• Consists of two parts: fixed and variable 

• Fixed part contains 

Event Flag mask word and address 

Initial values for PS, PC and SP 

Low-Core context: $DSW, and inpure storage area addresses 
for FCS, FORTRAN, etc. 

Pointers to specific areas within the variable part 

• Variable part contains 

Window blocks 
Logical unit table 
Task context 

• Window Block 

Describes task mapping 

Associates window with region 

Contains pointer to PCBs of regions used by task 
Pointers loaded at task installation 

Used to load APRs for task 
Initialized when task is installed 

• Logical Unit Table 

Contains a two word entry for each logical unit used by 
the task 

Word one: address of the UCB of the device assigned 
to the logical unit (UCB address loaded at task 
installation) 

Word two: address of the FILES-11 window block of an 
open file 
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The Task Image 

• Task code 

• Overlay information 

Autoload vectors 

Region and window descriptors for memory-resident overlays 

Segment descriptors 
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Figure 7-2 The Task, Header: Fixed Part 
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Figure 7-2 The Task Header: Beginning of Variable Part 
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Figure 7-2 The Task Header: End of Variable Part 



159 



TASK MANAGEMENT 



RUNNING A TASK 

• Performed by MCR RUN command 

Directives 

RUN$ 

RQST$ 

SPWN$ 

• If task not installed, use MCR command 

Task is installed with name equal to terminal, TTnn 

Task is executed 

Task is removed on exit 

• Two types of requests: 

Immediate request - is executed as soon as possible 
Time-dependent request 

Executed at a specified time 

Rescheduled to run periodically 

• Steps in running a task 

Task is installed 

Task is activated 

Memory is allocated to task 

Task is loaded 

Task is scheduled 

Task is terminated 
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Installing 

• Task is installed by MCR command 

Permanent installation by INS command 
Temporary installation by RUN command 

• TCB is created and initialized 

• Location T.PCB in TCB points to: 

The PCB of the partition or subpartition for which it was 
built (if partition is user-controlled) 

The PCB of the main partition (if partition is 
system-controlled) 



Locations T.LDV and T.LBN point to the load device and logical 
block number of the task image file 

Access rights to resident commons and libraries are checked 

Task TCB is inserted into the STD by routine $QINSP in module 
QUEUE 

Window blocks in header are initialized from the label blocks 

LUT is initialized from the label blocks and UCB addresses are 
loaded 
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Activating 

• Task placed in the Active Task List (ATL) 



• If task not installed and not privileged, it is temporarily 
installed 



Allocating Memory 

• Partition wait-queue used to schedule memory use 

Ordered by task priority 

Linked using T.LNK, the utility link word 

Starts at P. WAIT in PCB 

• TCB placed in partition wait-queue 

When task is requested 
When task is checkpointed 

Loading 

• Task placed in loader queue 

Utility link word, T.LNK, links TCBs in queue 
Location P. WAIT in PCB is queue listhead 

• In mapped system, task header copied into DSR 

Executive updates copy in DSR 

$DSW only data in task copy that is updated 
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Figure 7-3 The Loader Queue 
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Context Switching 

• Current task's context stored in task header 

• Task context includes: 

General registers (R0 - R5) 
Processor Status Word 
Stack pointer (R6) 
Program counter (R7) 
Floating-point registers 

• Mapping context for current task is not saved 

• New task's context is loaded from its header 

• Mapping context for new task created using window blocks and 
PCBs 
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Figure 7-4 Context Switching: Saving Context 
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Figure 7-4 Context Switching: Loading Context 
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Figure 7-5 The Data Structures for an Active Task 
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SCHEDULING A TASK 

Priority 

• Scheduling request sets value in $RQSCH 

• Value can be: 

The beginning of the ATL (e.g., after a significant event) 

Address of particular TCB (e.g., after a conditional 
scheduling request) 

• Scheduling algorithm scans the ATL beginning at the TCB whose 
address is in $RQSCH 

• System chooses: 

First resident unblocked task 
First task with a pending AST 

Round Robin 

• Tasks of the same priority share the CPU 

• Is a SYSGEN option 

• Parameters set at SYSGEN 

Round robin scheduling time interval 
Priority range for round robin 

• For each priority in priority range 

Sublist of tasks of that priority is scanned 

TCBs of blocked, suspended or waiting tasks are skipped 

TCB of first eligible task is placed last in list of tasks 
with same priority 
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Figure 7-6 Round Robin Scheduling: Interval #1 
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Figure 7-6 Round Robin Scheduling: Interval #2 
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Disk Swapping 

• Allows tasks of similar priority to share memory 

• Is a SYSGEN option 

• Parameters set at SYSGEN 

Swapping priority 

Time interval for swapping 

• Steps in disk swapping 

When task loaded, swapping priority is set at H.SPRI in 
the task header 

At the end of each swapping interval, H.SPRI is 
decremented 

H.SPRI is not decremented beyond the negative of the 
swapping priority 

For checkpointing, H.SPRI is added to the running priority 

When task is checkpointed , H.SPRI is set back to the 
swapping priority 
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Clock Scheduling 

• Provides facility for tasks to run 

At specific times 

After specific time intervals 

• When clock interrupt occurs, the clock queue is scanned 

• Types of time dependent requests 

Mark time request 

Task request with periodic rescheduling 

Single shot task request 

Single shot internal subroutine 
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Figure 7-7 Time-Dependent Scheduling 
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AST Processing 

• AST is used to notify a task when an asynchronous event has 
occurred 

• Three phases in processing an AST 

Specifying the AST 

Allocate an AST control block 
Fill in the type of AST at A.CBL 
Link the block to the TCB at T.SAST 

Declaring the AST 

Queue the AST control block to the AST queue at T.ASTL 

Scheduling the AST 

Conditional schedule request is made 

After context switch to task, RESCH in SYSXT attempts 
to dequeue an AST 

Stopped task is activated to process the AST, then 
stopped again 



• When an AST is scheduled 

Necessary data is pushed onto the task stack 
AST executes before return to task code 
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Figure 7-8 AST Processing: Sources of ASTs 
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Figure 7-8 AST Processing: Marktime Expiration 
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TASK MANAGEMENT 

TASK TERMINATION 

• Normal termination 

Task issues an exit directive 

• Abnormal termination 

Another task issues an abort directive 
Task is aborted by an MCR abort command 
Task is aborted because of an SST 

• Actions performed at task termination 

Halt task 

Cleanup system database 

Cancel mark time requests 

Break links to offspring tasks 

Disconnect interrupt vectors, if any 

If T3.REM = 1, deallocate TCB 

Deallocate header in pool if mapped system 

If abnormal exit, run TKTN 

Declare a significant event 

• I/O Rundown 

Kill all I/O on each assigned LUN 
Detach all attached devices 
Close all files opened by task 
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TASK MANAGEMENT 



Synchronous System Traps 

• Trap vector for each type 

• System response to SST 

Kernel mode: Crash system 

User mode: Abort task if no user SST vector 

Execute user-supplied routine if 
user SST vector 

Table 7-1 Synchronous System Traps 



Trap Trap Service 

Vector Routine Routine 

4 $TRP04 $TRP04 

250 $SGFLT $SGFLT 

14 $TRACE $TRACE 

20 $IOTRP SIOTRP 

10 $ILINS $ILINS 

30 $EMTRP $EMSST 

34 $TRTRP $TRTRP 

244 $FPPR8 $FPPR8 
(or $FPPR7) 



Cause 

Odd or nonexistent memory address error 

Memory protect violation 

T-bit or BPT instruction 

IOT instruction 

Reserved instruction 

Non-RSX EMT instruction 

TRAP instruction 

Synchronous floating-point exception 
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Figure 7-9 SST Processing 
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SYSTEM SYNCHRONIZATION 



SYSTEM SYNCHRONIZATION 



INTRODUCTION 

A large number of activities are in progress at any given 
time while an RSX-11M system is in use. System synchronization is 
the term given to the system processing which keeps these 
activities from interfering with each other. One important 
activity which must be controlled is access to the system data 
base. 



OBJECTIVES 

1. Describe how a software trap is processed by the system. 

2. Describe how a hardware interrupt is processed by the system. 

3. Describe FORK processing. 

4. Describe how a privileged task gets access to the system data 
base and code. 

RESOURCE 

1. RSX-11M System Lists and Data Structures 
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SYSTEM SYNCHRONIZATION 

OVERVIEW 

• Executive is driven by interrupts and traps 

Idle until interrupt or trap occurs 

• System operation 

Executive booted into memory by ROM 

ROM starts Executive by initializing PS and PC 

Executive initializes the environment 

Enables memory management unit 

Turns on clock 

Drivers called at powerfail entry points 

Executive drops into idle loop and waits for interrupts 
Command typed in at a terminal 
Interrupt occurs 
Command passed to MCR or DCL 
MCR or DCL runs a task 
Task may issue traps 

Clock may interrupt functions 
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System Synchronization Functions 

• Provides serial access to system database 

Process accessing system database 'owns' the database 
until finished 

•Race' conditions are avoided 

• Provides orderly method of allocating CPU use between user 
and system 

Software States 

• User State 

User code executing 

Processor in USER mode 

Processor fully interruptable - Hardware priority is 

• System State 

Only state in which the shared system database should 
be accessed 

Processor in KERNEL mode 

Processor fully interruptable - Hardware priority is 

• Interrupt Service State 

Used to perform critical operations after an interrupt 

Processor in KERNEL mode 

Processor not fully interruptable - Hardware priority 
between 4 and 7 
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SYSTEM SYNCHRONIZATION 



Software Processes 

• Process - A stream of code in KERNEL mode performinq a 
complete logical job 

Can be in the Executive or in a privileged task 

• There are three types of processes contained in the 
Executive 

Trap process 

Services a software trap 

Performed in system state 

Interrupt Process 

Services a hardware interrupt 
Performed in interrupt service state 

FORK Process 

Allows process or task to get access to system 
database 

Performed in system state 
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SYSTEM SYNCHRONIZATION 

The Stack Depth Indicator 

• One word' at location $STKDP in the Executive module SYSCM 

• Indicates software state and number of interrupts which 
have occurred in KERNEL mode 

Value of +1 indicates processing in user state 

Value of indicates processing in system or interrupt 
service state 

Trap or interrupt occurred from user state 



Negative value indicates processing in interrupt 
service state 

Trap occurred from system state 



• Each time trap or interrupt occur, $STKDP is decreased by 

1 

• Each time a trap or interrupt process completes, $STKDP is 
increased by 1 

Traps and Interrupts 

• CPU hardware performs following steps 

New program counter and processor status are obtained 
from the vector 

Current program counter and processor status are 
pushed onto current stack 

Current stack is KERNEL stack if mapped system 
Current stack is USER stack if unmapped system 



• New program counter contains address of trap service 
routine 

• New processor status causes 

Processor to change to KERNEL mode 
Processor priority to change to level 7 
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Figure 8-1 Handling Traps and Interrupts by the Hardware 
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SYSTEM SYNCHRONIZATION 



TRAP PROCESSING 



l. 

2. 

3. 
4. 



Trap caused by execution of a 'trap' instruction or 
synchronous system trap detected by the Executive 

Each type of trap corresponds to a unique two word vector in 
low memory 

Most common trap is • EMT 377' , the result of a directive call 

EMT instructions 

Cause a transfer to location $EMTRP in module DRSUB 

Processing occurs in module $DRDSP, the Directive 
Dispatcher 



DRSUB 



LOWCR 



EMT TRAP 
VECTOR 




SYSXT 



$DIRSV:: 



CALL (R5) 
BR SDIRXT 



$DIRXT:: -** 



RTI 



Figure 8-2 EMT Instruction Execution 
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SYSTEM SYNCHRONIZATION 

The Directive Save Routine 

• Code begins at label $DIRSV in module SYSXT 

• Called by trap processing routine upon entry 

• Processing in directive save routine 

Stack depth indicator is decremented to 

R5 is saved on current stack by JSR instruction 

R4 is saved on current stack 

On unmapped system, loads R6 with pointer to system stack 

R3, R2, Rl and R0 are saved on system stack 

Performs coroutine call back to DRSUB 

The Directive Exit Routine 

• Code begins at label $DIRXT in module SYSXT 

• Raises processor priority to 7 to lock out interrupts 

• Checks for waiting FORK process 

If so: maps driver using KERNEL APR 5 
transfers control to next FORK process 



• 



Increments $STKDP (Should now be +1) 

Restores general purpose registers 

Executes RTI instruction to return to USER mode 
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Figure 8-3 The Directive Save Routine 
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Figure 8-4 Common Processing in the Directive Dispatcher 
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Figure 8-5 The Directive Exit Routine 



204 



SYSTEM SYNCHRONIZATION 

INTERRUPT PROCESSING 

• Interrupt caused by hardware event 

• Device driver allows interrupt by setting ' interrupt-enable' 
bit device register 

• Each device controller has its own 2-word interrupt vector in 
low memory 

The Interrupt Save Routine 

• Code begins at label $INTSV in module SYSXT 

• Entry is with processor priority at level 7 to lock out other 
interrupts 

• Called by interrupt service routine upon entry 

• Processing in interrupt save routine 

Stack depth indicator is decremented by one 

R5 is saved on the current stack by JSR R5,$INTSV 

R4 is saved on the current stack 

On unmapped system, SP is loaded with the address of the 
system stack if entry is from user mode 

Processor priority is lowered to priority of the 
interrupting device 

Performs coroutine call back to the interrupt service 
routine 

• Several versions of this routine are available in module SYSXT 

$INTSV - Used by devices without error logging 
$INTSE - Used by devices with error logging 
$INTSC - Used by connect-to-interrupt routines 
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Figure 8-6 Interrupt Processing 
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SYSTEM SYNCHRONIZATION 

Device Driver Processing 

• Usually divided into three processing sections 

• Processor Status Word in vector causes entry into interrupt 
service routine at priority 7 

All interrupts are blocked 

Usually $INTSV is called and lowers priority 

• Critical processing is performed at the priority of the device 

For a terminal, the last input character is processed and 
the interrupt-enable bit is set for the next character 

If the system data base must be accessed, a FORK process 
is created 

• A device driver can access the system data base only as a FORK 
process 

A FORK process executes at processor priority 

The Interrupt Exit Routine 

• Code begins at label $INTX1 in the module SYSXT 

• Raises processor priority to 7 to lock out interrupts 

• Checks for waiting FORK process 

If one: lowers priority to 
saves R0 - R3 on system stack 
executes the $DIRXT routine 

• Increments $STKDP 

• Restores general registers 

• Executes RTI instruction to return to USER mode 
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Figure 8-7 The Interrupt Save Routine 
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Figure 8-8 The Interrupt Exit Routine 
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SYSTEM SYNCHRONIZATION 

FORK PROCESSING 

• Provides serial access to the system data base 

Processes needing access are queued 

No process gains access until the current process is 
finished with the system data base 

• Usually process is part of a device driver, but any privileged 
task can create a FORK process 

• Created by routines in module SYSXT 

$FORK - Used by device drivers 

$FORK0 - Creates FORK process without saving R4 and R5 

$F0RK1 - Creates FORK process saving R4 and R5 

$F0RK2 - Used by connect-to-interrupt routines 

The FORK Block 

• Four word block containing 

Link word for FORK list 
Saved PC 
Saved R5 
Saved R4 

• FORK block for device driver contained in the SCB 
The FORK List 

• FORK blocks are linked into FIFO queue called FORK list 

• Begins at list head in SYSCM at location $FRKHD 
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Figure 8-9 The FORK Block in the SCB 
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Figure 8-13 Interrupt Executive Processing an Interrupt 
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Figure 8-14 Interrupt Executive in an Idle Loop 
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SYSTEM SYNCHRONIZATION 

PRIVILEGED TASKS 

• Privilege bit is set in second status word in TCB 

Task can use privileged directives 

Task can perform privileged I/O functions 

Task can perform logical block transfers to/from mounted 
volumes 



• Task is built privileged by using the /PR switch when 
taskbuilding 

/PR:0 creates privileged task whose mapping is the same as 
that of a nonprivileged task 

/PR:n creates privileged task which maps to the Executive 

n = 4 if Executive is 16K words 
n = 5 if Executive is 20K words 
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SYSTEM SYNCHRONIZATION 

Processing a Privileged Task 

• Privileged task must switch to KERNEL mode to access system 
data base 

• Switch to KERNEL mode is performed by CALL $SWSTK, LABEL 
instruction 

CALL macro translates this to EMT 376 

CALL macro is in SY: [11, 10]RSXMC.MAC 

LABEL is a location in the privileged task to return when 
leaving KERNEL mode 

• In module DRDSP, a jump to location $SWSTK in module SYSXT is 
executed 

• The routine $SWSTK 

Moves the contents of USER mode APRs 5 and 6 to KERNEL 
mode APRs 5 and 6 

Moves the address of LABEL to location SP+16 on the stack 
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Figure 8-15 Privileged Task Processing 
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Figure 8-16 Privileged Task Switches Stack and Returns 
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WRITING PRIVILEGED TASKS 



INTRODUCTION 



necessary 
.n wa 
tool 



to 

not 

used 



In many practical environments, it is often 
write tasks which must interact with the Executive in ways 
planned by the designers of the operating system. The 
in these situations is the privileged task. (In this module, 
"privileged task" refers to a task which maps to the Executive.) A 
privileged task has access to both the system data base and 
Executive code and can therefore 
operating system. 



act as an extension of the 



To write and use privileged 
understand the operating system, 
methods that the Executive uses to 
system data base. The previous 
module, provides that understanding. 



tasks, the programmer must 

the system data base and the 

synchronize access to the 

modules, together with this 



OBJECTIVES 



1. Assemble and taskbuild privileged tasks. 

2. Use a privileged task to access the system data base. 

3. Use Executive routines to perform tasks. 



RESOURCES 



1. RSX-11M System Lists and Data Structures 
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WRITING PRIVILEGED TASKS 



OVERVIEW 

Why Write a Privileged Task 

• To acquire the privileged attribute 

Allows task to issue privileged directives 

Allows access to any file without protection checks 

Allows task to issue logical block I/O to a mounted volume 

• Tasks which map to the Executive have access to: 

Routines contained in the Executive 
Executive data base including 

System Common (SYSCM) 

System device tables (SYSTB) 

Dynamic Storage Region (POOL) 

The I/O Page 

Device registers 

Memory management registers 
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WRITING PRIVILEGED TASKS 

Privileged Task Structure 

• Consists of at least three sections 

First section 

Executes in USER mode 

Contains the transfer point of the task 

Contains code for processing before transferring to 
system state 

Second section 

Executes in KERNEL mode 

Contains code which accesses Executive data 

Third section 

Executes in USER mode 

Contains return location from KERNEL mode 

Contains code for processing data obtained from the 
Executive in the second section 

• USER Mode APRs 

For system with 16K word Executive 

APRs 0-3 are used to map the Executive 

APRs 4-6 are used to map the privileged task 

APR 7 is normally used to map the I/O page but can map 
an added 4K words of the task if needed 

Privileged task can be 

12K words if I/O page is needed in USER mode 

16K words if I/O page is not needed in USER mode 
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WRITING PRIVILEGED TASKS 



For system with 20K word Executive 

APRs 0-4 are used to map the Executive 

APRs 5 and 6 are used to map the privileged task 

APR 7 is normally used to map the I/O page but can map an 
added 4K words of the task if needed 

Privileged task can be 

8K words if I/O page is needed in USER mode 

12K words if I/O page is not needed in USER mode 
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WRITING PRIVILEGED TASKS 



Restrictions on Privileged Tasks 

• Parameter Passing 

User state to system state 

Values can be passed in registers R0 - R5 
Values can be passed in memory locations 

System state to user state 

Values can only be passed in memory locations since 
registers are restored 

• Time spent in system state should be minimal 

Interrupt processing affected since the FORK queue is not 
serviced 

No other user task can execute 

• No trap can occur in system state 

No directives can be executed 

Traps in system state cause a system crash 

• Privileged instructions should be used with care 
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CREATING A PRIVILEGED TASK 
Assembling a Privileged Task 

• To assemble a privileged task to map to the Executive: 

>MAC File,File=[l,l]EXEMC/ML, [11, 10] RSXMC/PA: 1, [USER UIC]File 

• EXEMC.MLB 

Contains 

Macros defining offsets 

Bit values for all system data structures 

Not needed if no reference is made to these structures 

• RSXMC.MAC 

Contains 

Conditional assembly symbols defining the system 
Several commonly used macros such as CALL and CALLR 

Always needed to interpret CALL $SWSTK 
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Taskbuilding a Privileged Task 

• The following command is needed to taskbuild a privileged task 
which maps to the Executive 

>TKB File/PR:n=File,[l,l]EXELIB/LB,[l,54]RSXllM.STB 

• EXELIB. 

Executive object library 

Contains global symbols for resolving offsets in data 
structures not resolved during assembly 

• RSX11M.STB 

Executive symbol table file 

Allows resolution of Executive global symbols used in 
privileged task 
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WRITING PRIVILEGED TASKS 



SAMPLE PRIVILEGED TASKS 
Tracing Through System Lists 

• Function of privileged task 

Calculate and display size of free pool 

• The pointer $CRAVL is used to access the list of free pool 
blocks 

• $SWSTK is used to switch to system state 

• Time spent in system state is minimal 

System data accessed in system state 

• I/O performed in user 

No traps in system state 

• Size of free pool is saved before return to user state 

Registers cannot be used to pass data from system to user 
state 
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WRITING PRIVILEGED TASKS 



Table 9-1 Pointers to System Lists 



Pointer* 

$LOGHD 

$CRAVL 

$ACTHD 

$CFLPT 

$FRKHD 

$CLKHD 

$PARHD 

$TSKHD 

$GGEF 

$ERHEA 

$PKAVL 

$UMRHD 

$UMRWT 

$MOULS 

*A11 pointers 



System List 

Logical device assignment list 
Free pool block listhead 
Active task list listhead 
Pointer to first checkpoint file PCB 
FORK queue listhead 
Clock queue listhead 
Pointer to partition list 
Pointer to system task directory 
Pointer to group global event flags list 
Error logging message queue listhead 
Pointer to list of preallocated I/O packets 
Mapping assignment block listhead 
UMR wait queue listhead 
Mounted device listhead 
are located in SYSCM 
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WRITING PRIVILEGED TASKS 



Table 9-2 Pointers to Data Structures 

Pointer* Description 

$HEADR Pointer to current task header 

$TKNPT Pointer to TKTN TCB 

$SHFPT Pointer to shuffler TCB 

$MCRPT Pointer to MCR TCB 

$TKTCB Pointer to current task TCB 

$LDRPT Pointer to loader TCB 

*A11 pointers are located in SYSCM 
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POOLA 



MACRO M1200 29-DEC-81 13:54 PAGE 3 



.TITLE POOLA 



U) 



6 








7 








8 








9 








10 


000000 






11 


000030 






12 


000032 


124 


117 


13 




000045 




14 


000053 






15 








16 


000120 






17 


000120 


005001 




18 


000122 


012700 


0000006 


19 


000126 






20 


000132 


066001 


000002 


21 


000136 


011000 




22 


000140 


001374 




23 


000142 


006201 




24 


000144 


010167 


177660 


23 


000150 


000207 




26 








27 








28 








29 


000152 


012700 


000053' 


30 


000156 


012701 


000032' 


31 


000162 


012702 


000030' 


32 


000166 






33 


000172 


010167 


177620 


34 


000176 






35 


000204 






36 




000120' 





** 



POOLA 



DISPLAY POOL SIZE 



124 



0UTQI05 

arglst: 
outmes: 

BUFFL 

outbuf: 
start: 



io*: 



30* : 



THIS TASK WILL CALCULATE AND DISPLAY THE TOTAL 
DYNAMIC STORAGE REGION SIZE 



SYSTEM 



.MCALL 
•NLIST 
QIOW* 
. BLKW 
.ASCIZ 

.BLKB 
.EVEN 

CLR 

MOV 

CALL 

ADD 

MOV 

BNE 

ASR 

MOV 

RETURN 



QIOW*fEXIT*S»DIR* 

BEX 

I0.WVBf1f1»f>f <OUTBUF r Of 40> 

1 % ARG LIST FOR *EDMSG 

/TOTAL POOL = ZD./ 

.-OUTMES+20. 

BUFFL 



Rl 

♦*CRAVL»RO 

*SWSTKf30* 

2<R0>fR1 

<RO)rRO 

10* 

Rl 

Rlr ARGLST 



FOR TOTAL FREE SPACE 
POINT TO FIRST DSR PACKET 
SWITCH TO SYSTEM STATE 
i ADD IN SIZE OF THIS PACKET 
8 GET LINK TO NEXT PACKET 
i IF NE NOT END OF LIST 
! CONVERT TO WORDS 
! SAVE SIZE OF DSR 
> RETURN TO USER STATE 



FORMAT AND PRINT OUTPUT 



MOV 

MOV 

MOV 

CALL 

MOV 

DIR* 

EXIT*S 

• END 



♦OUTBUFfRO 

♦OUTMESfRI 

♦ARGLST fR2 

♦EDMSG 

RIfOUTQIO+0. 

♦OUTQIO 

START 



} SET OUTPUT STRING 

t AND INPUT STRING 

t AND ARGUMENT LIST 

f FOR EDIT MESSAGE 
IOPL+2 f UPDATE MESSAGE SIZE 

f WRITE OUT MESSAGE 

f AND EXIT FROM PROGRAM 
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Example 9-1 



Tracing Through System Lists 
(Sheet 1 of 2) 



to 
-J 



POOLA 


MACRO Mi 200 


29-DEC--81 


13 J 54 PAGE 3- 


1 












SYMBOL, 


rABLE 


















ARGLST 


000030R 


G**TTK» 


000000 


L**P11= 


000002 


Q.IOSB= 


000010 


T**BTW<= 


000000 


A**CHK>- 


000000 


H**RTZ= 


000074 


L$*11R== 


000000 


R**CON== 


000000 


T**CCA" 


000000 


A**CLI= 


000020 


I0.WVB= 


****** GX 


M**CRB== 


000124 


R**DER== 


000000 


T*»COM= 


000000 


A»*CNT= 


000000 


I*»CSZ== 


000200 


M**CRX™ 


000000 


R**DSP= 


000000 


Tt$CON= 


000000 


A**CPS= 


000000 


I**RAR= 


000000 


M**EXT= 


000000 


R**EIS= 


000000 


T**CTR= 


000000 


A**NSI= 


000000 


I*$RDN== 


000000 


M**FCS== 


000000 


R**EXV= 


000000 


Tt$CUP= 


000000 


A»*PRI= 


000000 


K**CNT= 


177546 


M**M0E= 


000000 


R**HDV= 


000000 


T**C11= 


000001 


A**TRP= 


000000 


K**CSR== 


177546 


M**MIJP= 


000000 


R»»H11= 


000004 


T**ESC= 


000000 


BUFFL == 


000045 


K**DAS= 


000000 


M**NET= 


002627 


R**JP1= 


000004 


T$$GMC:= 


000000 


C**CDA= 


000002 


K'**IEN= 


000115 


M**0VR= 


000000 


R*»JS1= 


000004 


T**GTS= 


000000 


c:»$ckp-- 


000000 


K**LDC= 


000001 


M**XLN= 


000400 


R**K11--- 


000001 


T**KMG= 


000000 


c:**int== 


000000 


K*$TPS= 


000074 


N*»LDV= 


000001 


R**LKL= 


000001 


T$*LUC= 


000000 


G**0RE== 


001000 


L.D*C0 = 


000000 


N**MOV= 


000041 


R**LU = 


000001 


T*$M03:= 


000002 


C*»RSH» 


177564 


LD*DB == 


000000 


N**UMR= 


000030 


R**MPL= 


000000 


T**REB= 


000000 


C«*RUN-= 


000000 


LD$DD = 


000000 


OUTBUF 


000053R 


R**M11= 


000004 


T*$RNE= 


000000 


D**HU = 


000003 


LD4DK = 


000000 


OUTMES 


000032R 


R**NDC= 


000006 


T**RPR= 


000000 


IJ**IAG= 


000000 


LDSDL = 


000000 


OUTQIO 


OOOOOOR 


R**NDH= 


000226 


T**RST= 


000000 


n**rsK= 


000000 


LBtBM = 


000000 


P**D70= 


000000 


R**NDL= 


000001 


T**RUB- 


000000 


D**L11= 


000001 


LD*DR = 


000000 


P**GMX= 


000000 


R*«SND= 


000000 


T**SMC= 


000000 


D**M11= 


000003 


LD*DS = 


000000 


P**LAS= 


000000 


R*$X21= 


000001 


T*»UTO= 


000036 


»*$PAR" 


000000 


LD$DT = 


000000 


P*$MAX= 


000400 


R**11M= 


000000 


T**U58= 


000001 


B**SHF= 


000000 


LD*DY = 


000000 


P**OFF= 


000000 


R**611= 


000001 


U*«DAS= 


000000 


I)«$UCK= 


000000 


LD»LP = 


000000 


P**OOL= 


000000 


START 


000120R 


U*$MHI= 


000000 


D*»YNC= 


000000 


L.D4MM = 


000000 


P**P45= 


000000 


S*$ECC= 


000000 


U**MLO^ 


140000 


D**YNM= 


000000 


LD*NL = 


000000 


P$*RFL= 


000000 


S**HDW= 


000000 


U**MRN= 


170230 


I)**ZMD= 


000000 


LB*RB = 


000000 


P**RTY= 


000000 


S**LIB= 


000000 


y**CTR= 


000774 


i:i4*Zll = 


000001 


LD*TT = 


000000 


P**SRF= 


000000 


S**NM1= 


042513 


U$*TLD= 


000120 


E**DVC= 


000000 


LD*VT = 


000000 


P**UND= 


000000 


S**NM2= 


046522 


V**TLM= 


000205 


E**NSI== 


000000 


LK.SPN= 


000002 


«**OPT= 


000005 


S**NM3= 


052111 


V*$TRM= 


000000 


E$*PER= 


000000 


LK.UIAT = 


000010 


Q.IOAE= 


000012 


S**OPT= 


000000 


X**DBT= 


000000 


E**XPR= 


000000 


L**ASG= 


000000 


Q.IOEF= 


000006 


S*«UBD= 


000000 


X**HDR= 


000000 


F**LPP= 


000000 


L**DBG= 


000000 


Q.IOFN--= 


000002 


S«*WPC= 


000036 


*CRAVL/= 


****** GX 


F**LVL= 


000001 


l..**DRV= 


000000 


Q.IOLU= 


000004 


S**WPR-- 


000005 


*EDMSG~ 


****** GX 


0**TPP= 


000000 


L**L.DR= 


000000 


O.IOPL= 


000014 


S**WRG== 


000000 


$«*ARG= 


000003 


G»»TSS» 


000000 


L*$PTO= 


000170 


Q.IOPR= 


000007 


S**YSZ= 


044000 


***OST== 


000014 



S3 



O 

T3 
50 



f 

m 

O 
PI 

a 
> 

CD 

en 



. ABS. 000000 000 
000212 001 
ERRORS detected: 

VIRTUAL MEMORY USEDt 11375 WORDS ( 45 PAGES) 

DYNAMIC MEMORYt 12692 WORDS ( 48 PAGES) 

ELAPSED TIMEJ 00 t 00 t 12 

r POOLA=LB t C2 r 54 JRSXMC/PA : 1 r C 1 1 1 1EXEMC/ML t DB2 1 C305 , 306 3P00L A 



Example 9-1 Tracing Through System Lists 
(Sheet 2 of 2) 



WRITING PRIVILEGED TASKS 

Calling Executive Routines 

• Function of privileged task 

To simulate issuing an MCR command from a terminal 

• Privileged task must construct MCR command block 

Terminal UCB is located by searching device list 

MCR command block (84 bytes) is allocated from pool by 
using routine $ALOCB 

Block is queued to MCR by using routine $QMCRL 

Block is deallocated on I/O error by calling $DEACB 

• Time spent in system state is minimized by returning to user 
state to perform calculations, etc. 



Table 9-3 Executive Pool Routines* 

Entry 

Point Description Inputs Outputs 

$ALOCB Allocates a variable Rl = Size of C-bit = Block allocated 

length core buffer buffer C-bit = 1 Insufficient space 

R0 - Address of block 
First fit Rl - Length of block 

Length in multiples 
of four bytes 

$DEACB Deallocates a variable R0 = Address None 
length core buffer of block 

Rl = Block 
size 

*A11 routines are in Executive module CORAL 
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WRITING PRIVILEGED TASKS 



Table 9-4 Executive Queueing Routines* 



Entry 
Point 

$QINSF 



$QINSP 



$QINSB 



Description 

Inserts entry at end 
of FIFO queue 

Saves R0, Rl 

Inserts entry in a 
priority ordered 
queue 

Saves R0, Rl 

Inserts entry at 
beginning of queue 

All registers are 
saved 



(Same as $QINSF) 



Outputs 
None 



Inputs 

R0 » Address of 

listhead 
Rl = Address of 

new entry 

(Same as $QINSF) None 



$QRMVF Removes entry from 
beginning of queue 

Saves R0 

$QRMVT Removes entry with 

a spec! fed TCB address 



$QMCRL Queues a command line 

to CLI of issuing terminal 



R0 = Address of 
1 isthead 



R0 
Rl 



Address of 
1 isthead 



C-bit = Entry removed 
C-bit = 1 Empty list 
Rl - Address of entry 



C-bit = Entry removed 
C-bit = 1 Entry not found 



TCB address Rl - Address of entry 



Rl = Address of None 
command line 



*A11 routines are in Executive model QUEUE 
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WRITING PRIVILEGED TASKS 





Table 9- 


-5 


Other Executive R 


Entry 
Point 


Description 




Inputs 


$SRSTD 


Searches STD for 
specified task 




R3 = Address of 
RAD50 task 




Module: REQSB 




name 


$SRNAM 


Search the partiti* 
list for a named 


yt\ 


R3 • Address of 
RAD50 name 



partition 

Module: PLSUB 

$CEFI Converts an event 
flag number to an 
event flag address 



Module: EXESB 



Outputs 

C-bit - Task found 
C-bit = 1 Task not found 
R0 = TCB address of task 



C-bit = Partition found 
C-bit « 1 Not found 
R2 » PCB address 



R0 * Event flag R0 
number Rl 

R5 = TCB address 
of task 



Mask word 

Event flag address 



240 



TERM 



MACRO Ml 200 22-0CT-81 12 $40 PAGE 3 



N) 



9 

3 








} + 


4 










5 










6 










7 










a 










9 










10 










11 










12 










13 










14 










15 










16 










17 










18 










19 










20 










21 








H- 


22 










23 000000 










24 










OET 










t. vJ 










26 










27 000000 


012 


015 


105 


PRMT X 


000003 


116 


124 


105 




000006 


l r -'2 


040 


10.1 




000011 


040 


124 


105 




000014 


1 22 


115 


111 




000017 


116 


101 


114 




000022 


040 


.1.16 


125 




000025 


115 


102 


105 




000030 


122 


072 


040 




28 


000033 






PLEN 


29 000033 


105 


116 


124 


MES1$ 


000036 


105 


122 


040 




000041 


101 


040 


103 




000044 


117 


115 


115 




000047 


101 


116 


104 




000052 


040 


106 


117 




000055 


1 22 


040 


115 




000060 


103 


122 






30 


000027 






LENT1 


31 000062 


116 


125 


115 


MESS1 


000065 


102 


105 


122 




000070 


040 


111 


123 




000073 


040 


116 


117 




000076 


124 


040 


117 




000101 


103 


124 


101 




000104 


1 1 4 


054 


040 




000107 


124 


122 


131 




000112 


040 


101 


107 




000115 


101 


111 


116 




000120 


041 








32 


000037 






L.EN1 



.TITLE TERM 

THIS TASK ASKS THE USER FOR A TERMINAL NUMBER AND A 
COMMAND LINE. IT THEN PASSES THE COMMAND TO MCR 
AS IF HAD ORIGINATE!) AT THE SPECIFIED TERMINAL. IT 
PERFORMS THIS TASK BY USING SYSTEM SUBROUTINES , *ALOCB 
AND SOMCRLf TO ALLOCATE A BLOCK FROM POOL AND PASS IT 
TO MCR. 

the task must be built privileged and map to the executive, 
to assemble: 

>MAC TERM=C 1 y 1 3EXEMC/ML t C 1 1 , lOIIRSXMC/PA $ 1 , t < YOUR UIC ) 3TERM 

to build: 

>TKB TERM/PR :5--=TERM, tl »34.1RSX11M.STB/SS 



.MCALL EXIT*S>OIOU*S»DCBDF* 
DCBDF* 



TERMINAL MESSAGES 

.ASCII <12><15>/ENTER A TERMINAL NUMBER: / 



J PROMPT 



-PRMT 



f LENGTH OF PROMPT 



.ASCII /ENTER A COMMAND FOR MCR/ 



,-MESl 
.ASCII /NUMBER IS NOT OCTAL? TRY AGAIN!/ 



30 



33 



f 

O 

M 
O 

-3 
> 
en 

en 



-MESSl 
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Calling Executive Routines 
(Sheet 1 of 5) 



TERM 



MACRO M1200 22-0CT-81 12M0 PAGE 3-1 



to 



33 000121 
000124 
000127 
000132 
000135 
000140 
000143 

34 

35 000144 
000147 
000152 
000155 
000160 
000163 

36 

37 000166 
000171 
000174 
000177 
000202 
000205 
000210 
000213 
000216 

38 

39 

40 

41 

42 

43 000220 

44 000224 

45 000230 

46 000232 

47 000234 
40 000236 
4? 000240 

50 000242 

51 000244 

52 000246 
53 

54 
55 

56 000250 

57 000322 

58 000374 
5? 000400 
60 000404 
6.1 000406 
62 

63 

64 000412 

65 000414 

66 000416 

67 000422 

68 000426 

69 000432 

70 000434 



124 
115 
101 
116 
040 
125 
041 

000023 
116 
120 
114 
126 
114 
114 

000022 
111 
040 
122 
040 
040 
115 
116 
111 
125 

000032 



124 
177777 
000000 
000000 
000000 
000000 
000000 
000000 



016703 
012700 
005002 



005702 
001402 
000167 

012700 
011000 
001422 



105 
111 
114 
117 
106 
116 



117 
117 
040 
101 
101 
105 

057 
105 
117 
117 
103 
115 
104 
116 
124 



124 



177626 
000220' 



000436 
000000(3 



122 
116 
040 
124 
117 
104 



040 
117 
101 
111 
102 
041 

117 
122 
122 
116 
117 
101 
040 
120 



ERMESJ .ASCII /TERMINAL NOT FOUND!/ 



ERL - .-ERMES 

POOL! .ASCII /NO POOL AVAILABLE!/ 



PL = .-POOL 

IOERRt .ASCII !I/0 ERROR ON COMMAND INPUT! 



IOL 



-IOERR 



.EVEN 



PROGRAM DATA 



buf: 


.BLKB 


4 


iosb: 


• BLKU 


i 


nam: 


.ASCII 


/TT/ 


ERRCNTS 


.UORD 


-1 


comm: 


• WORD 





place: 


.UORD 





ucb: 


. UORD 





dcb: 


.UORD 





low: 


.UORD 





high: 


.UORD 






BEGINNING OF CODE 



term: 



cont: 
li: 



QI0W4S 

QIOU*S 

MOV 

MOV 

CLR 

CALL 



TST 

BEQ 

JMP 

CALL. 

MOV 

MOV 

BEQ 



*I0.UVBf#5f*1 

*I0.RVBf#5f#1 

I0SB+2fR3 

♦BUFfRO 

R2 

*COTB 



R2 

CONT 

ERR1 

♦SWSTKfBACK 

**DEVHDfRO 

< RO > f RO 

GO 



f-MAKE SURE OF UORD BOUNDARY 



f BUFFER FOR TERMINAL NUMBER 

fI/O STATUS BLOCK 

fTERMINAL NAME 

JERROR INDICATOR 

f ADDRESS OF COMMAND LINE IN POOL 

f ADDRESS OF POOL BLOCK 

f SAVED UCB ADDRESS 

f SAVED DCB ADDRESS 

fSAVED LOW UNIT NUMBER 

fSAVED HIGH UNIT NUMBER 



f f f f <#PRMT f #PLEN f #40> f PROMPT 
ff#I0SBff<#BUFf#4> fGET 'TT' NUMBER 
SAVE CHARACTER COUNT 
SET UP FOR CALL TO CONVERSION 

ROUTINE - FROM ASCII TO 
BINARY (OCTAL) 

Rl WILL CONTAIN 

R2 UILL CONTAIN 
TEST FOR ERROR 
IF NOT CONTINUE 
GO TO ERROR ROUTINE 
fSUITCH TO SYSTEM STATE 
fPICK UP LISTHEAD FOR DCB LIST 
J GO TO NEXT DCB 
fIF NONE FINISH UP 
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en 
?? 
en 



CONVERTED NUMBER 
TERKINATOR 



Example 9-2 



Calling Executive Routines 
(Sheet 2 of 5) 



TERM 



tfc. 



1 


MACRO f 


1200 21 


-OCT -81 


12 J 40 PAGE 3-2 








71 


000436 


026760 


1 77566 


000004 




CMP 


NAMfD.NAM(RO) 




72 


000444 


001372 








BNE 


LI 




73 


000446 


116067 


000006 


177570 




MQVB 


D. UNIT <RO>f LOU 




74 


000454 


116067 


000007 


177564 




MOVE 


n.UNlT+l(RO)»HIGH 




75 


000462 


020167 


177560 






CMP 


RIfHIGH 




76 


000466 


003361 








BGT 


LI 




77 


000470 


010067 


1 77546 






MOV 


RO t DCB 




713 


000474 


062767 


000001 


177530 




ABB 


#1f ERRCNT 




79 


000502 








001 


RETURN 






(30 


000504 








back : 








(31 


000504 


005767 


177522 






TST 


ERRCNT 




(3:j 


000510 


001402 








BEtt 


1* 




83 


000512 


000167 


000430 






JMP 


ERR2 




84 


000516 


016700 


177520 




l*: 


MOV 


BCBi-RO 




(35 


000522 


016002 


000002 






MOV 


D.UCB<R0)fR2 




8 6 


000526 


0.10104 








MOV 


R1fR4 




(37 
OE) 
(39 


000530 


166704 


177510 






SUB 


L0WfR4 




000534 


016005 


000010 






MOV 


D.UCBL<R0>fR5 




90 


000540 


070504 








MUL 


R4fR5 




91 


000542 


060502 








ABB 


R5 t R2 




912 


000544 


010267 


177470 






MOV 


R2fUCB 




9;s 


000550 


012767 


177777 


177454 




MOV 


*-l - ERRCNT 




94 


000556 










CALL. 


*SWSTKfBACK2 




95 


000562 


012701 


000124 






MOV 


*84.fR1 




96 


000566 










CALL 


*ALOCB 




97 


000572 


103404 








BCS 


NONE 




98 


000574 


005267 


177432 






INC 


ERRCNT 




99 


000600 


010067 


177432 






MOV 


ROr PLACE 




100 


000604 








none: 


RETURN 






101 


000606 








BACK2: 








102 


000606 


005767 


177420 






TST 


ERRCNT 




103 


000612 


001402 








BEO 


1* 




104 


000614 


000167 


000406 






JMP 


ERR3 




ioa 


000620 


012700 


000124 




i*{ 


MOV 


#84.fR0 




106 


000624 


016701 


177406 






MOV 


PLACE fRI 




107 


000630 


112721 


000040 




2*: 


MOVB 


#40f(R1>+ 




1013 


000634 


077003 








SOB 


R0f2$ 




109 


000636 


016767 


177374 


177370 




MOV 


PLACE fCOMM 




110 


000644 


062767 


000004 


177362 




ABB 


*4fC0MM 




111 


000652 










ClIQWUS 


*I0.WVBf*5f#1ffff< 


#MES 


112 


000724 


005067 


177274 






CLR 


IOSB 




113 


000730 


005067 


177272 






CI...R 


IOSB+2 




114 


000734 










QIOU*S 


#I0.RVBf*5f*1ffI0E 


B F f < 


11H 


001006 


103002 








BCC 


3* 




116 


001010 


000167 


000272 






JMP 


ERR4 




117 


001014 


105767 


177204 




3*: 


TSTB 


IOSB 




118 


001020 


002002 








BGE 


4* 




119 


001022 


000167 


000260 






JMP 


ERR4 




120 


001026 








4$: 


CALL 


*SWSTKfBACK3 




121 


001032 


016701 


177200 






MOV 


PLACE fRI 




122 


001036 


016761 


177176 


000002 




MOV 


UCB»2(R1) 




123 


001044 










CALL 


*QMCRL 




124 


001050 










RETURN 






125 


001052 








BACK3! 








126 


001052 










EXIT*S 






127 










? 









fLOOK FOR 'TT' bcb 

fIF NOT 'TT' GET NEXT DCB 

JGET LOU UNIT NUMBER 

J GET HIGH UNIT NUMBER 

» COMPARE INPUT WITH HIGH 

SIF INPUT LARGER GET NEXT BCB 

fSAVE DCB ADDRESS 

f INDICATE NO ERROR HERE 

f RETURN TO USER STATE 

NOW IN USER STATE 

TEST FOR ERROR 

CONTINUE IF OK 

GO TO ERROR ROUTINE 

GET BCB ADDRESS 

GET ADDRESS OF FIRST UCB 

MOVE FOR CALCULATIONS 

FIND THE NUMBER WITHIN UCBS 

FOR CURRENT DCB 
GET UCB LENGTH 
CALCULATE OFFSET FOR UCB 
CALCULATE BEGINNING OF UCB 
SAVE UCB ADDRESS 
RESET ERROR COUNT 
f SWITCH TO SYSTEM STATE 
fSET BLOCK SIZE 
f ALLOCATE BLOCK FROM POOL 
fNO ROOM IN POOL 
VINDICATE NO ERROR HERE 
J SAVE ADDRESS OF POOL BLOCK 
f RETURN TO USER STATE 
BACK IN USER STATE 
CHECK FOR ERROR 
CONTINUE IF OK 
GO TO ERROR ROUTINE 
SET LENGTH OF BLOCK 
GET ADDRESS OF BLOCK- 
PLACE BLANKS IN BLOCK 
LOOP UNTIL THROUGH 
CALCULATE LOCATION OF COMMAND 
LOCATION IN BLOCK 
1f#LENT1f*40> f PROMPT FOR COMMAND 



C0MMf#80.> f INPUT COMMAND 
i CONTINUE IF OK 
f BRANCH IF 010 ERROR 
f CHECK FOR I/O ERROR 
f CONTINUE IF OK 
f BRANCH IF ERROR 
>» SWITCH TO SYSTEM STATE 
f'fGET ADDRESS OF BLOCK 
it PLACE UCB ADDRESS IN BLOCK 
ff QUEUE BLOCK TO MCR 
f f LEAVE SYSTEM STATE 
fBACK IN USER STATE 

» ex it- 
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TERM 



to 

45. 



MACRO M1200 22 


-0CT-81 


128 






129 






130 001060 






131 001132 


012700 


000220 


132 001136 


005020 




133 001140 


077302 




134 001142 


000167 


177102 


135 






136 






137 






138 001146 






139 001220 






140 






141 






142 






143 001226 






144 001300 






145 






146 






147 






148 






149 001306 






150 001360 






151 001364 


016700 


176646 


152 001370 


012701 


000124 


153 001374 






154 001400 






155 001402 






156 001402 






157 


000250' 





12 J 40 PAGE 3-3 

r 
r 

erri: 

CLEARS 



ERR2 



ERR3: 



ERR4! 



fin: 



ROUTINE TO HANDLE BAD TERMINAL NUMBER 

OlOUiS *I0.UVB»#5»#lFF»r<*MESSir#LENlr#40> SPRINT MESSAGE 

MOV #BUF»RO SGET INPUT BUFFER ADDRESS 

CLR <R0)+ SCLEAR BUFFER 

SOB R3fCLEAR SR3 CONTAINS CHARACTER COUNT 

JMP TERM STRY AGAIN 

ROUTINE TO HANDLE NON-EXISTENT TERMINAL 



OIOW*S *I0.UVB»*5f*lF r »><#ERMES»#ERL»#40> 
EXIT*S SEXIT 

ROUTINE TO HANDLE POOL ALLOCATION FAILURE 



QIOW*S 
EXIT*S 



#10 . WVB r*5>tlM>> <*POOL t #PL t #40> 

SEXIT 



SPRINT MESSAGE 



SPRINT MESSAGE 



ROUTINE TO HANDLE I/O ERRORS ON COMMAND INPUT 
THE POOL BLOCK MUST BE DEALLOCATED! 

QIOW*S #I0.WVBj#5>#ljFFf<#I0ERRf#I0Lr*40> SPRINT MESSAGE 

CALL *SWSTK,FIN SSSWITCH TO SYSTEM STATE 

MOV PLACE »R0 SSGET ADDRESS OF BLOCK 

MOV #84.»R1 SSSET BLOCK LENGTH 

CALL *DEACB SS DEALLOCATE BLOCK- 

RETURN SSLEAVE SYSTEM STATE 

SBACK IN USER STATE 
EXIT*S SEXIT 

.END TERM 
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TERM 


MACRO Ml 


200 22--0CT--81 


12J 40 PAGE. 3- 


-4 












SYMBOL. 


TABLE 


















A**BIO= 


OOOOOO 


D.MSK 


000014 


K**IEN= 


000113 


PRMT 


OOOOOOR 


T**BTW= 


OOOOOO 


A*$BRT= 


000000 


D.NAM 


000004 


K*$LDC= 


000144 


P**BPR= 


000063 


T$*BUF= 


OOOOOO 


A**CHK= 


OOOOOO 


D.PCB 


000034 


K*$TPS= 


000144 


P**CTL= 


OOOOOO 


T**CCA= 


OOOOOO 


A**CLI= 


000004 


D.UCB 


000002 


LD*CO ■- 


OOOOOO 


P»*FRS= 


000310 


T**CCO» 


OOOOOO 


A**CPS« 


OOOOOO 


D.UCBL 


000010 


L»*DD » 


OOOOOO 


P*$GMX= 


OOOOOO 


T$*CPW= 


OOOOOO 


A**NSI== 


OOOOOO 


D.UNIT 


000006 


LD*DK = 


OOOOOO 


P**HIL» 


003100 


T**CTR= 


OOOOOO 


A**PRI== 


OOOOOO 


D.VCAN= 


000002 


LD*DL = 


OOOOOO 


P**LAS= 


OOOOOO 


T**CUP= 


OOOOOO 


A**TRP== 


OOOOOO 


D.VDEB= 


177776 


LD*DM = 


OOOOOO 


P**LOL- 


001130 


T**C11= 


000001 


BACK 


000504R 


D.VINI<= 


OOOOOO 


LD*DR = 


OOOOOO 


P**OFF= 


OOOOOO 


T*»ESC= 


OOOOOO 


BACK2 


000606R 


D.VOUT= 


000004 


LD*DS = 


OOOOOO 


P**P45= 


OOOOOO 


T**GMC= 


OOOOOO 


BACK3 


001052R 


D.VPWF= 


000006 


LD*DT " 


OOOOOO 


P*»RFL= 


OOOOOO 


T$*GTS= 


OOOOOO 


BUF 


000220R 


ERL. 


000023 


LD*LP = 


OOOOOO 


P*$RTY= 


OOOOOO 


T*$HFF= 


OOOOOO 


»**l.Vl== 


030463 


ERMES 


000121R 


LD*MM = 


OOOOOO 


P**SRF= 


OOOOOO 


T**HLD= 


OOOOOO 


B»*LV2= 


020040 


ERRCNT 


000232R 


LD*TT = 


OOOOOO 


0**OPT= 


000005 


T**J16= 


000001 


CLEAR 


001136R 


ERR1 


001060R 


LENT1 = 


000027 


R**DER= 


OOOOOO 


Tt*KMG= 


OOOOOO 


COMM 


000234R 


ERR2 


001146R 


LEN1 ■■= 


000037 


R**EXV= 


OOOOOO 


T**LWC= 


OOOOOO 


COHT 


000422R 


ERR3 


001226R 


LOU 


000244R 


R**JS1= 


000001 


T**RED= 


OOOOOO 


C**CDA== 


000002 


ERR4 


001306R 


L**ASG= 


OOOOOO 


R**K11- 


000001 


T**RNE= 


OOOOOO 


C$*CHE= 


OOOOOO 


E**ACT= 


OOOOOO 


L**DRV= 


OOOOOO 


R**LKL= 


000001 


T**RPR» 


OOOOOO 


c**ckp= 


000004 


E*»DVC== 


OOOOOO 


Lt*L»R= 


OOOOOO 


R**l.ll = 


000001 


T**RST= 


OOOOOO 


G**CSR= 


1.77404 


E**LOG= 


OOOOOO 


L**PTO= 


000036 


R**MOF= 


OOOOOO 


T**RUB= 


OOOOOO 


C**INT== 


OOOOOO 


E**XPR= 


OOOOOO 


L**P11= 


000001 


R**M11= 


000001 


T»»S«C= 


OOOOOO 


«::**ons= 


000001 


FIN 


001402R 


LI 


000432R 


R**NDC= 


000005 


T**SYN= 


OOOOOO 


c:»*ore= 


002022 


F**LPP= 


OOOOOO 


MESS1 


000062R 


R**NBH= 


000226 


T**TRW= 


OOOOOO 


C:*tOTM== 


OOOOOO 


F**LVL= 


000001 


MES1 


000033R 


R**NDL= 


000001 


T*$UTB= 


OOOOOO 


c:**rsh= 


177564 


GO 


000502R 


M*$CRB= 


000124 


R**POI= 


OOOOOO 


T**UTO= 


000170 


C**RIJN== 


OOOOOO 


G**EFN= 


OOOOOO 


M**CRX= 


OOOOOO 


R**SND= 


OOOOOO 


T**U58= 


000001 


C**SMT'= 


OOOOOO 


G$$TPF= 


OOOOOO 


M*$EIS~- 


OOOOOO 


R**11M= 


OOOOOO 


T**VBF= 


OOOOOO 


C**TTY== 


177564 


G**T£>S= 


OOOOOO 


M**EXT= 


OOOOOO 


R**60F= 


OOOOOO 


T**30P= 


OOOOOO 


ncB 


000242R 


G**TTK= 


OOOOOO 


M**FCS= 


OOOOOO 


R**611= 


000001 


UCB 


000240R 


n**nii=-- 


000001 


HIGH 


000246R 


M**MGE= 


OOOOOO 


S**ECC= 


OOOOOO 


IJ**MHI = 


OOOOOO 


D»»IAG= 


OOOOOO 


H**RTZ= 


000074 


M*$MUP<= 


OOOOOO 


S**NM1= 


051522 


U**MLO= 


160000 


D**ISK= 


OOOOOO 


IOERR 


000166R 


M**OVR= 


OOOOOO 


S**NM2<= 


030530 


U**MRN= 


170234 


D»*L11= 


000002 


IOL 


000032 


NAM 


000230R 


S**NM3= 


046461 


V**CTR= 


000400 


D**M11== 


000001 


IOSB 


000224R 


NONE 


000604R 


S**TIM= 


OOOOOO 


V*»RSN= 


000040 


I1**PAR= 


OOOOOO 


IO.RVB= 


****** 6X 


N**L»V= 


000001 


S**TQP= 


OOOOOO 


Xt*DBT= 


OOOOOO 


D»*SHF= 


OOOOOO 


IO.WVB= 


****** OX 


N**MOV= 


000041 


S**WLK= 


OOOOOO 


*ALOCB= 


****** GX 


n*«wcK-- 


OOOOOO 


I**RAR= 


OOOOOO 


N$*UMR= 


000034 


S**WPC= 


000036 


•COTB = 


****** GX 


I)**YNC= 


OOOOOO 


I**RDN- 


OOOOOO 


PL 


000022 


S**WPR= 


000005 


*»EACB= 


****** GX 


D**YNM« 


OOOOOO 


K**AST= 


OOOOOO 


PLACE 


000236R 


S*$YSZ= 


022000 


*DEVHB= 


****** GX 


1.1 . HBP 


000012 


K**CNT= 


172542 


PLEN = 


000033 


TERM 


000250R 


*GMCRL= 


****** GX 


B . LNK 


OOOOOO 


K**CSR= 


172540 


POOL 


000144R 


T**ACR= 


OOOOOO 


**$ARG= 


000002 


. ABS. 


000036 
001410 


000 
001 
















Ei.RRORS 


DETECTED J 




















s: 

50 
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a 
o 
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VIRTUAL MEMORY USED? 10113 WORDS < 40 PAGES) 
DYNAMIC MEMORY: 16120 WORDS ( 62 PAGES) 

elapsed time: oo : 00 : 14 
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SYSTEM CRASHES 



INTRODUCTION 

Only certain carefully defined SSTs are allowed in system 
state. System crashes occur when a software fault is recognized 
within system state. The processor trap mechanism signals the 
system crash. CDA is a SYSGEN option which aids the system 
programmer in tracing system faults. When a fault occurs, the 
Executive trap handling facility saves the register context in 
memory, then passes control to the crash routine, which dumps the 
memory to a disk or tape. The CDA utility may be used to format 
the dump information into a convenient report. 



OBJECTIVES 

1. To analyze a report generated by CDA to determine the cause of 
a system crash. 



RESOURCES 

1. RSX-11M/M-PLUS Crash Dump Analyzer 

2. RSX-11M System Lists and Data Structures 
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CRASH PROCESSING 
Causes of Crashes 

• Processor traps in system state 

Powerfail and parity error traps do not cause crash 
Other processor traps cause system crash 
System automatically crashes 

• Processor HALTs or enters infinite loop 

System must be manually crashed 

• Manually crashing the system 

Physical location 40 contains the instruction JMP $CRASH 
Processor halted 
Address 40 loaded 
Processor restarted 

Crash Sequences 

• Three different crash sequences 

Initiated by IOT 
Initiated by EMT or TRAP 
Initiated by other trap 

Odd address 

Illegal instruction 

Memory management fault 

Floating-point fault/PIRQ 
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Crash Sequences ■ 

• IOT 

Used when system detects an inconsistent system state 
Sequence : 

IOT trap vectors to the module SSTSR 

R0 - R5 are not saved 

Only PS and PC are pushed onto the stack 

Jump to $CRASH in module CRASH is executed 

Executive issues IOT only in modules DRDSP and SSTSR 

• EMT or TRAP 

Results from EMT or TRAP attemp in system state 
Sequence: 

Directive save operation is performed 

Executive issues IOT 

Continue as with the IOT 

• Other Traps 

Traps vector to module SSTSR 

Directive save operation is performed 

If Memory Management Fault, the status registers SR0, SRI, 
and SR2 are pushed onto the stack 

One word fault code is pushed onto the stack 

Byte count of the information saved is pushed onto the 
stack 

Executive jumps to $CRASH 
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Obtaining a Crash Dump Analysis 

• If XDT is present, respond with X to continue with crash 

• Registers are printed on the console printer; the system 
halts 

• Mount crash dump volume and press the continue switch 

• After memory contents is saved, boot the system 

• Run CDA to produce the analysis 

Inputs: The copy of memory created at the crash or by a 
previous execution of CDA 

The symbol definition file for the system 

Outputs: A listing file containing the analysis of the dump 

A binary file which is a copy of the contents of 
the crash dump volume 

• Command Format: 

>CDA <CR> 

CDA> [listf ile/sw] , [binaryf ile/sw] =symbolf ile/STB, 

crash-input[/sw] 

• Two types of switches can be used 

Analysis switches - determine which CDA routines are 
applied to the input 

Function switches - provide control options 
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CRASH DUMP ANALYSIS 

Finding the Cause of a System Crash 

• Usually requires 

Output from the CDA utility 
Map of the operating system 
Listings and maps of relevant tasks 

• Common steps in interpreting a crash dump 

Get KERNEL stack pointer 

Examine KERNEL stack and $STKDP for sequence of events 
(i.e., traps and interrupts) 

Find PC and PS when trap occurred (from KERNEL stack) 

Determine APRs in use and find which APR mapped the 
instruction at which the crash occurred 

Use the Memory Map to locate the proper partition or 
region 

Use the listing and map of the code occupying the region 
to locate the instruction 

• System data base may have been corrupted long before crash 
occurred 

'Current Task' may not have caused crash 
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Table 10-1 CDA Switches 

CDA Analysis Switches 

/ACT Lists the TCBs for active tasks 

/CLQ Lists the contents of the clock queue 

/DEV Lists the information on all devices in the system 

/HDR Lists the headers for all resident tasks 

/PCB Lists the PCBs 

/POOL Lists the contents of POOL 

/STD Lists the contents of the STD 

/ALL Lists the output of all analysis routines 

/DUMP:a:b 

Lists the contents of memory between the 18-bit 
addresses a and b 

/TASK=name:a:b 

Lists the virtual space of task 'name' between the 
16-bit address a and b 

Note: All analysis switches are used with the crash-input 

CDA Function Switches 

/LIMITtn Limits output listing to n pages 

Used on the list file 
/MEMSIZ:n Saves nK words of memory in a binary file 

Used on the binary file 
/STB Identifies the symbol definition file 

Used on the STB file for the system 
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Basic Information Provided in a CDA 

The KERNEL Stack and $STKDP 

• The KERNEL stack provides a record of the system entrances 
since system state was entered 

• Each trap and interrupt causes task context to be saved on the 
KERNEL stack 

• $STKDP indicates how many times context has been saved 

• Contents of stack can be partitioned by locating the saved PSs 

Each PS indicates the start of context saved by a trap or 
an interrupt 

PS on stack located by position on stack 

First entry on stack is PS from first trap or 
interrupt 

Next PS will be nine words further on stack if trap or 
fork occurred 

Next PS will be five words further on stack if 
interrupt occurred 

Context pushed because SST contains 11 words plus 
extra trap specific words 

If an SST occurred, it is always the last context on stack 

Contents of the APRs 

• Determines mapping between virtual and physical addresses 

KERNEL APRs show mapping when crash occurred 
USER APRs show mapping of current user task 
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SP 



$STACK 




Figure 10-1 The Stack After a System Crash - IOT 
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$STACK 



PC 



PS 



RETURN TO $DIRXT 



RO 



R1 



R2 



R3 



R4 



R5 



PC 



PS 



Figure 10-2 The Stack After a System Crash - EMT 
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SP«^*- 


BYTE COUNT 




FAULT CODE 




TRAP SPECIFIC 
DATA 




RETURN TO $DIRXT 




RO 




R1 




R2 




R3 




R4 




R5 




PC 




"~ PS 






$STACK 





Figure 10-3 The Stack After a System Crash - SST 
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Table 10-2 Fault Codes for SSTs 
Code Number of Bytes SST Trap 

4 Traps through vector 4 (Odd address, 

etc .) 

2 10 Segment fault 

4 4 Trace or break-point instruction 

6 4 IOT instruction 

10 4 Illegal or reserved instruction 

11 6 Non-RSX EMT trap instruction 

16 14 Floating-point exception (11/40) 
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KERNEL Stack Pointer = 000562 

Location Contents 

000556 024552 - PC at Crash 

000560 000010 - PS at Crash SST Information 

000562* 000004 - Number of bytes 

000564 000000 - SST Code 

000566 003120 - Addr of $DIRXT 

000570 000001 - R0 

000572 070514 - Rl 

000574 074460 - R2 

000576 053204 - R3 Context at SST 

000600 144000 - R4 

000602 000000 - R5 

000604 121204 - PC 

000606 030000 - PS 

000610 003126 - ADDR of $DIRXT 

000612 000000 - R0 

000614 070514 - Rl 

000616 074460 - R2 Context at Trap 

000620 053200 - R3 

000622 144000 - R4 

000624 000000 - R5 

000626 121206 - PC 

000630 170000 - PS 

Example 10-1 A Sample KERNEL Stack 
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AN EXAMPLE 

Situation 

• Privileged task TT2 is executing. 

Task prompts for terminal number. 

User enters terminal number. 

System crashes. 

CDA prints message: 

Pool link error at 000040 — FWD ptr = 000167 
Size = 001736 
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Output from CDA 

• Current task = RMDEMO 
Error indicates 



Error caused by another task 

Other task corrupted list of free pool blocks 



• Contents of KERNEL stack indicate crash caused by IOT 

Consistent with pool pointer = 000167 

Note that 000167 is JMP instruction and 001736 is location 
of $CRASH 



• Any recently or currently active privileged tasks may have 
caused crash 

• Examination of listing of task TT2 shows that task allocates 
and uses a block of pool 

Address of pool stored at location PLACE in task 

Task map indicates address of PLACE is 121430 

• Dump of task obtained from binary crash file 

Value of 054100 stored in PLACE 

• Examination of pool dump indicates 

Value 000040 entered in 84 words starting at 054100 
Allocated block started at 054100 and contained 84 bytes 
Error at location 000630 in task: MOV should be MOVB 
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RSX-11M CRASH DUMP ANALYZER 
VOLATILE REGISTERS 



V4.0 



i-nov-si 



11:16 



PAGE 1 



AFTER CRASH: PS=000340 SP<K>=000660 SP(U)=121164 
BEFORE CRASH: PC=141362 PS=030000 

R0=137034 Rl=137034 R2=131120 R3=000000 R4=000167 
MMRO=000001 MMR1=000000 MMR2=002326 MMR3=000060 



R5=137014 





U S 


E R 




I S P 


ACE 


D S P 


ACE 


PDR 


PAR 


PDR 


PAR 


077306 


000000 


000000 


000000 


077406 


000200 


000000 


000000 


077406 


000400 


000000 


000000 


077406 


000600 


000000 


000000 


077406 


001000 


000000 


000000 


077506 


004732 


000000 


000000 


033006 


005132 


000000 


000000 


077406 


177600 


000000 


000000 



SUPERVISOR 



I S P 


ACE 


D S P 


ACE 


PDR 


PAR 


PDR 


PAR 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 




K E R 


N E L 




I S P 


ACE 


D S P 


ACE 


PDR 


PAR 


PDR 


PAR 


077506 


000000 


000000 


000000 


077506 


000200 


000000 


000000 


077506 


000400 


000000 


000000 


077406 


000600 


000000 


000000 


077506 


001000 


000000 


000000 


077506 


004732 


000000 


000000 


077406 


005132 


000000 


000000 


077506 


177600 


000000 


000000 



N I 


BUS M 


1 


00000000 


r> 


00020000 


3 


00040000 


4 


00060000 


5 


00100000 


6 


00146200 


7 


00166200 


8 


17000000 


9 


17000000 


10 


17000000 


11 


17000000 


12 


17000000 


13 


17000000 


14 


17000000 


15 


17000000 


16 


17000000 


17 


17000000 


18 


17000000 


19 


17000000 


20 


17000000 


21 


17000000 


22 


17000000 


23 


17000000 


24 


17000000 


25 


17000000 


26 


17000000 


27 


17000000 


28 


17000000 


29 


00045100 


30 


17760000 


31 


00105100 



M A P 



Example 10-2 CDA - Volatile Registers 
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RSX-11M CRASH DUMP ANALYZER- 
KERNEL STACK 



V4.0 



1-N0V-81 



ii:i6 
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KERNEL STACK: 



000400 
000420 
000440 
000460 
000500 
000520 
000540 
000560 
000600 
000620 
000640 
000660 
000700 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
006110 
026304 
000000 
003236 
170000 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
133304 
001000 
000002 
000000 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
131514 
044000 
131542 
000144 
136256 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
131534 
025312 
160020 
000000 
131120 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
133054 
132602 
133040 
036154 
000000 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
133036 
030000 
010024 
137014 
136320 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
123156 
026304 
011604 
141362 
134554 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
001662 
001000 
124670 
030000 
142576 



Example 10-3 CDA - KERNEL Stack 
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SYSTEM CRASHES 



RSX-11M CRASH DUMP ANALYZER V4.0 1-N0V-81 11U6 PAGE 3 
SYSTEM COMMON 



CRASH OCCURRED AT 11:12:27 1-N0V-81 



CURRENT TASK = RMDEMO TCB ADDRESS = 052110 

*SYSID = 31 *EXSIZ = 120000 «SYSIZ = 9216. /288K *SYUIC = CI, 543 
*STKDP ~ 000000 *COMEF: <33~48> 000000 <49-64> 000000 
SYSTEM NAME = RSX11M *NTUIC = 111,543 

LOAD DEVICE = DRO LBN = 00135325 FILE SIZE = 496. 
SYSTEM FEATURE MASK (FIRST WORD) = 013377 
BIT SET MEANING 



EXT 22-BIT EXTENDED MEMORY SUPPORT 

MUP MULTI-USER PROTECTION SUPPORT 

EXV 20K EXEC SUPPORTED 

DRV LOADABLE DRIVER SUPPORT 

PLA PLAS SUPPORT 

CAL DYNAMIC CHECKPOINT SPACE ALLOCATION 

F'KT PREALLOCATION OF I/O PACKETS 

EXP EXTEND TASK DIRECTIVE SUPPORTED 

OFF PARENT/OFFSPRING TASKING SUPPORTED 

FDT FULL. DUPLEX TERMINAL DRIVER 

DYM DYNAMIC MEMORY ALLOCATION SUPPORTED 



SYSTEM FEATURE MASK (SECOND WORD) = 167400 
BIT SET MEANING 



DPR DIRECTIVE PARTITION SUPPORT 

IRR INSTALL r REQUEST t AND REMOVE TASK SUPPORT 

GGF GROUP GLOBAL EVENT FLAG SUPPORT 

RAS RECEIVE/SEND DATA PACKET SUPPORT 

RBN ROUND ROBIN SCHEDULING SUPPORTED 

SWP EXECUTIVE LEVEL DISK SWAPPING SUPPORTED 

STP EVENT FLAG MASK IS IN THE TCB 



SYSTEM FEATURE MASK (THIRD WORD) = 025214 
BIT SET MEANING 



CLI MULTIPLE CLI SUPPORT 

EIS SYSTEM REQUIRES THE EXTENDED INSTRUCTION SET 

STM SYSTEM HAS SET SYSTEM TIME DIRECTIVE 

AST SYSTEM HAS AST SUPPORT 



Example 10-4 CDA - System Common 
(Sheet 1 of 3) 
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SYSTEM CRASHES 



RSX-11M CRASH DUMP ANALYZER 
SYSTEM COMMON DUMP 



V4.0 



1-N0V-81 



11 :ia 



PAGE 4 



A DDR 



LABEL VALUE 



ADDR 



LABEL VALUE 



ADDR 



LABEL VALUE 



007750 010316 

000207 
♦HEADR 052654 

160400 
*COMEF 000000 

000000 
$SYSID 030463 

020040 



010110 *PRIHL 003100 
fPRILL 001130 
*PFRSZ 000310 
*POLBP 000063 
SPOLFL 000000 
*PARPT 017320 
*CLKHD 045716 
*COPT 043630 



oio: 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



007770 $TKNPT 110610 

$SHFPT 111040 

$CKCNT 172542 

*CKCSR 172540 

*CKLDC 000144 

*SYUIC 000454 
000000 

*EXSIZ 120000 



010130 *PARHD 117734 
♦LDRPT 117510 
♦TSKHD 117510 
*XC0M1 001200 
*XC0M2 001345 
*GGEF 000000 
*GFTCB 010150 
*GEFPT 010150 



010270 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
$ERBAF 000000 



010010 *PWRFL 000000 
*SIGFL 000000 
*LOGHD 000000 
$MCRCB 000000 
$LSTLK 000000 

000003 
*CRAVL 046464 

000000 

010030 *ACTHD 117510 
$DICSV 001037 
*TKTCB 052110 
*LBUIC 000454 
*ABTIM 041233 
$RQSCH 000000 
$STKDP 000000 
*DEVHD 040746 



010150 *GEFDM 000254 

$IDLCT 000001 

*IDLPT 170017 

♦DYPMN 020035 

020037 

020037 

017440 

017440 

010170 020040 
$BTMSK 000001 
000002 
000004 
000010 
000020 
000040 
000100 



010310 



010330 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 

000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



010050 tRNDCT 000005 
*SWPCT 000036 
♦ERRPT 000000 
*CFLPT 050740 
000000 
026354 
$INTCT 177777 
*FRKHD 000000 



010210 



010070 



010066 
*FMASK 013377 
167400 
025214 
*HFMSK 000003 
$PTTCB 112314 
SPRISZ 033364 
$POLST 000401 



010230 



000200 
000400 
001000 
002000 
004000 
010000 
020000 
040000 

100000 
*ERHEA 000000 

010232 
$ENTSQ 000000 
*ERRSG 000000 
*ERFLA 000000 

000000 

000000 



010350 000000 

*ERFID 000000 

000000 

000000 

000000 

000000 

$PRMOD 000106 

*SYSIZ 022000 



010370 



*DPM 



000000 
135325 
051104 
000760 
177777 
000015 
000037 
000030 



Example 10-4 CDA - System Common 
(Sheet 2 of 3) 
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SYSTEM CRASHES 



RSX-11M CRASH DUMP ANALYZER 
SYSTEM COMMON DUMP 



V4.0 



1-N0V-81 



11U6 



PAGE 5 



ADDR 



LABEL VALUE 



ADDR 



LABEL VALUE 



ADDR 



LABEL VALUE 



010410 




000074 


010470 


*PKAVL 


054034 






000074 




*PKNUM 


002403 




♦ TKPS 


000144 




*MXEXT 


177777 






000121 




*UMRHD 


000000 






000013 




*UMRPT 


170200 






000001 






000034 






000013 




$UMRWT 


000000 






000014 






010504 


010430 




000033 


010510 


*TEMP0 


111750 




$TTNS 


000063 




♦TEMPI 


052514 




$TLMTS 


000200 




$TEMP2 


130562 






000000 




$TEMP4 


000000 






000014 




$AVRHD 


000000 






000001 




*MOULS 


047064 






000000 




*CXDBL 


000000 






000001 




*SYSNM 


051522 


010450 




000027 
000000 


010530 




030530 
046461 






000073 




*CLICQ 


000000 






000000 






010534 






000073 




*CPTBL 


010550 






000000 






052464 




$TIKLM 


000143 
000000 






000000 
000000 



010550 *MCRPT 111750 
050712 
000000 
000040 
003404 
005015 
000076 
005015 



010570 



041515 
037122 
000000 



Example 10-4 . CDA - System Common 
(Sheet 3 of 3) 
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SYSTEM CRASHES 



RSX-llf 
SYSTEM 


i CRASH 
COMMON 


DUMP ANALYZER V'4.0 
ALPHABETIZED DUMP 


1-N0"v 


'-81 11U6 


PAGE 6 


♦ABTIM 


041233 


♦ERLOF 


000 


♦MOULS 


047064 


♦STKDP 


000000 


♦ACTHD 


117510 


♦ERRPT 


000000 


♦MXEXT 


177777 


♦super 


000036 


♦AVRHD 


000000 


♦ERRSG 


000000 


♦NTUIC 


000454 


♦SYSIZ 


022000 


♦CFLPT 


050740 


♦EXSIZ 


120000 


♦PARHD 


117734 


♦SYSNM 


051522 


♦CKCNT 


172542 


♦FMASK 


013377 


♦PARPT 


017320 


♦SYUIC 


000454 


♦CKCSR 


172540 


♦FRKHD 


000000 


♦PFRSZ 


000310 


♦TEMPO 


111750 


♦CKLDC 


000144 


♦GEFDM 


000254 


♦PKAVL 


054034 


♦TEMPI 


052514 


♦CLICQ 


000000 


♦GEFPT 


010150 


♦PKMAX 


005 


♦TEMP2 


130562 


♦CLKHD 


045716 


♦GFTCB 


010150 


♦PKNUM 


003 


♦TEMP4 


000000 


♦COPT 


043630 


♦GGEF 


000000 


♦POLBP 


000063 


♦TKNPT 


110610 


*CF'TBL 


010550 


♦HEADR 


052654 


♦POLFL 


000000 


♦ TKPS 


000144 


♦CRAVL 


046464 


♦HFMSK 


000003 


*POLST 


000401 


♦TKTCB 


052110 


♦CURPR 


341 


*IDLCT 


001 


♦PRIHL 


003100 


♦TSKHD 


117510 


♦CXDBL 


000 


♦IDLFL 


000 


♦PRILL 


001130 


♦ TTNS 


000063 


♦DEVHD 


040746 


♦IDLPT 


170017 


♦PRISZ 


033364 


♦UMRHD 


000000 


♦DICSV 


001037 


♦INTCT 


177777 


♦PRMOD 


000106 


♦UMRPT 


170200 


*DPM 


000037 


♦LBUIC 


000454 


♦PTTCB 


112314 


♦UMRWT 


000000 


♦ENTSQ 


000000 


*LDRPT 


117510 


♦PWRFL 


000000 


♦UTCSR 


017320 


♦ERBAF 


000 


♦LOGHD 


000000 


♦RNDCT 


000005 


♦WTDUM 


017320 


*ERFID 


000000 


♦LSTLK 


000000 


♦RQSCH 


000000 


♦XC0M1 


001200 


♦ERFLA 


000 


$MCRCB 


000000 


♦SHFPT 


111040 


♦XC0M2 


001345 


♦ERHEA 


000000 


♦MCRPT 


111750 


♦SIGFL 


000000 







Example 10-5 CDA - System Common Alphabetized Dump 
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SYSTEM CRASHES 



RSX-11M CRASH DUMP ANALYZER 
POOL STATISTICS 



V4.0 



1-N0V-81 



11J16 



PAGE 7 



Pool link error at 000040 



FWD Ptr = 000167 Size - 001736 



POOL SIZE (BYTES) = 21376. 
LARGEST FREE BLOCK (BYTES) = 36. 
TOTAL FREE BYTES = 144. 
NUMBER OF FRAGMENTS = 13. 
MINIMUM BLOCK SIZE (BYTES) = 4. 



POOL BITMAP (CONSTRUCTED FROM LINKED POOL. BLOCK FREE IF BIT SET): 



000000 
000000 
000000 
000000 
000000 
000000 
017740 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



000000 
001400 
000000 
000000 
000000 
170000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



060000 
000000 
000000 
000000 
000000 
000037 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



002014 
000000 
000000 
000000 
007600 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



000000 
000000 
000000 
000000 
002000 
003400 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



000200 
000000 
000001 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



001000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



Example 10-6 CDA - POOL Statistics 
(Sheet 1 of 2) 
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SYSTEM CRASHES 



RSX-11M CRASH DUMP ANALYZER 
POOL STATISTICS 



Y4.0 



1-N0V-81 



n:i6 



PAGE 8 



OOOOOO 000000 000000 000000 000000 000000 

000000 OOOOOO OOOOOO OOOOOO OOOOOO OOOOOO OOOOOO 

OOOOOO OOOOOO OOOOOO OOOOOO OOOOOO OOOOOO OOOOOO 

OOOOOO OOOOOO OOOOOO OOOOOO OOOOOO OOOOOO 

OOOOOO OOOOOO OOOOOO OOOOOO OOOOOO OOOOOO 



OOOOOO OOOOOO 
OOOOOO 
OOOOOO 

OOOOOO OOOOOO 



Example 10-6 CDA - POOL Statistics 
(Sheet 2 of 2) 



271 



SYSTEM CRASHES 



RSX-11M CRASH DUMP ANALYZER 
ACTIVE TASKS 



V4.0 



1-N0V-B1 



11!16 



PAGE 19 



TT2 



TCB ADDRESS = 054440 PAR = GEN PCB ADDRESS = 055174 
LOAD ADDRESS = 00440400 LOAD DEVICE = SYOJ LBN = 00117403 
PRI = 50. I/O COUNT = 1. UIC = C7»3773 TI = TT2t 
MAX SIZE == 000031 EVENT FLAGS = <1-16> 000000 <17~32> 000000 



t.stat: 

T.ST2: 
T.ST3J 



-CHK UFR 

-PMD REM PRV MCR 



T.TIOt 000000 

TCB DUMP 5 

000000 000000 000462 000000 

000020 054456 000000 000000 

000040 000062 117403 046166 

000060 000031 047102 047102 

000100 054536 000000 000001 



100100 
044256 
055174 
000000 



000000 
007754 
000031 
000000 



000000 054452 000000 

000000 020001 074000 

111404 000000 000000 

000000 054532 000000 



054462 000000 



Example 10-7 CDA - Active Tasks: TT2 
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SYSTEM CRASHES 



RSX-11M CRASH DUMP ANALYZER- 
TASK HEADERS 



V4.0 



i-Noy-8i 



ii:i6 



PAGE 30 



000040 
000060 
000100 
000120 
000140 
000160 



000000 
000376 
000000 
000000 
132277 
000000 



000000 
000000 
042360 
046116 
046430 
177777 



055102 
000000 
000000 
000000 
000123 
044000 



000001 
000000 
043630 
046072 
000000 
000000 



126202 
000000 
000000 
000000 
000612 
000056 



000000 
055144 
046166 
000001 
051006 
120533 



000000 
000007 
000000 
053654 
170000 
000000 



000000 
046072 
046072 

120000 
124636 



TT2 



HEADER ADDRESS = 054554 TCB ADDRESS = 054440 

F'S=170000 PC=122200 

R0=000000 Rl=054350 R2=044336 R3=000001 R4=000001 R5==000060 SP=121172 

INITIAL PS = 170017 INITIAL PC = 121442 INITIAL SP = 121172 

HEADER SIZE = 122. NO. OF WINDOWS = 1. NO. OF LUNS = 6, 

CURRENT UIC = £7,3773 DEFAULT UIC = [7,3773 

H.WND = 054702 H.GARD = 054744 H.VEXT = 000000 H.SPRI = -5. 

DSW = 000001 H.FCS = 000000 H.FORT = 000000 H.OVLY == 000000 

LOGICAL UNIT TABLE J 



* 


DEV 


WINDOW 


1 


SYOJ 


000000 


2 


syo: 


000000 


3 


syo: 


000000 


4 


SYO J 


000000 


5 


not 


000000 


6 


clo: 


000000 



U.CTL W.FCB F.FNUM F.FSEG F.STAT NAC NLCK 



WINDOW BLOCKS t 

PAR VIRT LIMITS ATT DESC WND SIZE OFFSET 1ST PDR NO. LAST PDR 
GEN 120000 123077 047074 000031 000000 177612 1 014006 

header: 

000000 121172 000172 053254 135600 003777 003777 170017 121442 

Example 10-8 CDA - Tasks Headers: TT2 
(Sheet 1 of 2) 
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SYSTEM CRASHES 



RSX-llM CRASH DUMP ANALYZER 
TASK HEADERS 



V4.0 



1-N0V-81 



11J16 



PAGE 31 



000020 
000040 
000060 
000100 
000120 
000140 
000160 



121172 
000000 
000373 
000000 
000000 
000031 
00000.1 



000000 
000000 
000000 
046166 
046116 
000000 
044336 



000000 
054702 
000000 
000000 
000000 
000612 
054350 



000000 
000001 
000000 
046166 
000001 
014006 
000000 



000000 
000000 
000000 
000000 
055174 
170000 
000000 



000000 
000000 
054744 
046166 
120000 
122200 



000000 
000000 
000006 
000000 
123077 
000060 



000000 

000000 
046166 
046072 
047074 
000001 



Example 10-8 CDA - Tasks Headers: TT2 
(Sheet 2 of 2) 
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SYSTEM CRASHES 



RSX-11M CRASH DUMP -ANALYZER 
POOL DUMP 



V4.0 



1-N0V-81 



n:i6 



PAGE 82 



053260 

053270 

053300 

053310 

053320 

053330 

053340 

053350 

053360 

053370 

053400 

053410 

053420 

053430 

053440 

053450 

053460 

053470 

053500 

053510 

053520 

053530 

053540 

053550 

053560 

053570 

053600 

053610 

053620 

053630 

053640 

053650 

053660 

053670 

053700 

053710 

053720 

053730 

053740 

053750 

053760 

053770 

054000 

054010 

054020 

054030 

054040 

054050 

054060 

054070 

054100 



* 
* 
* 

* 



114250 
000000 
000401 
000016 
000401 
114730 

* 066117 

* 000033 
053640 
000000 
053640 
000403 
000000 
143107 
170017 
000000 
000000 
053552 
143142 
000000 
000006 
000000 
000000 
000000 
144277 
001212 



000616 
000000 
* 000060 
054224 
000403 
026226 
004076 
000000 
000000 
000000 
007537 
053736 
054440 
000062 
000306 
000306 
000000 
054016 
000000 
000020 
135154 
005077 
000000 
000040 



053276 
000106 
115404 
121350 
000000 
121246 
131574 
000000 
000044 
000000 
000024 
000000 
000000 

* 000000 

* 120750 

* 000000 
000000 
000002 
000000 
000000 
0461.66 
041006 
046072 
000002 
052360 
021006 
053270 
066402 
000000 
120431 
000014 
000000 
000000 
000123 
111404 
046430 
000062 
000000 
177776 
100400 
142440 
054440 
000000 
000000 
000000 
000000 
000000 
005103 
140144 
000000 
000040 



000001 
114250 
000000 
000000 
000000 

* 000000 

* 000000 

* 000000 
111404 
000001 
000000 
053640 
120412 
000454 
120412 
000000 
000000 
143030 
000373 
000000 

oooooo 

000000 

oooooo 

* 046674 

* 000243 
115404 
000156 
170000 
143107 

* OOOOOO 
OOOOOO 

* 054374 

* 055174 

* OOOOOO 

* 000050 

* 046430 

* OOOOOO 

* 053732 

* 000001 
020000 
046142 
OOOOOO 
054002 
054012 
000003 
055240 



+ 044416 
+ 140054 
+ 000070 
+ OOOOOO 
* 000040 



115404 
OOOOOO 
001000 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
041740 
111426 
OOOOOO 
000010 
000212 
000454 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
053634 
043630 
046166 
046116 
120000 
OOOOOO 

* 160000 

* 000147 
121016 
000060 
OOOOOO 
OOOOOO 
000062 
115274 
000123 
054750 
OOOOOO 
131574 
OOOOOO 
044000 
050000 
115274 
OOOOOO 
OOOOOO 
OOOOOO 
053742 
000044 
000400 
OOOOOO 
OOOOOO 
OOOOOO 
000040 



XQ 

FO 

N 

FQ 

XXX 

QMB 

* 

N 2 

N 2 
FS 

1.9 
8P0 



M9R 
1/Z 



2D1 

PJ 
IU 
18 

AH 
NF6 

FS 
GEN 
ALO 



BRO 

NBN 

NJP 

AJ 

D8 

D8 

NCV 

P 
/3D 
AYW 



M5F 

AO 

X2D 

ZBX 

Z 8 



XQ 



Y6H 



LIN 
JW 
LG4 
B 
MWX 
EQO 
M5 
QQZ 

Y1A 

L 



BC 
UT6 
LMP 

A J 

8N 
TYX 
1UX 
NJP 



LOT 
DC 

X2D 
BO 

8P 

1.9 



AY* 
OIL 



NIT 
NSD 

A 
LMP 

NBJ 

A 

ED2 

LH4 

NCJ 
NCR 
C 
NT 
K$M 
0/6 
AP 



X2D ! ! ( 
; | 

L2! ! 
j j 
! I 
! !X 



F ( 



8" 



WT6 
A 

N 2 

YOZ 

GT 

YOZ 



J4P! 
UUN! 



! !01!3 
i ! 

! ! U* 



! U 



H! ! 
CR ! ! 
GT ! ! GF 

! ! ph! 

i j 

i i 



1*2 
FK 



N 

KRH! ! 
LIN! ! 
LHN! ! 
YX ! ! 



! !JU 
! !bF 

i i 



vL 
B 

:l 



w 

G 
vL 
NL 



<M 



! ! ?HpT* 
53X ! ! 

Bid ! ■ -CSVr. a 
Y7F ! ! it. p ' 
AH! ! GFO 
! !0 ! 
! ! X 



M 



AJ! ! 
XOL! ! 
BC ! ! } 

NOP ! ! 
; | 

... ! ! 2 
! j _ 

KT2! !"W" 
L2 ! ! Y 
XOL! !2 

! !F 

! !F 

I i 

NBR ! ! X 
6! ! 
FP ! ! 

! !ltC f@ 
! !? d<?8 
! ! 
2 • i 



! X2 
! Z< 
S 
( hY 
M 
!3 
ZU 
H 
P 
EbL< 
Y 
X 
X 

bid 
Z* 
I 



CABOVE LINE REPEATED 9. TIMES] 

054220 * 000040 * 000040 000040 000040 ! 2 
054230 000040 000040 000040 000040 ! 2 



2 ! ! 
21 i 
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054240 




000040 




000040 




000040 




000040 


2 


2 


2 


2 ! 




054250 




000040 




000040 




000040 




000040 


2 


2 


o 


2 ! 




054260 




000040 




000040 


* 


000040 


* 


000040 


2 


2 


2 


2 i 




054270 


* 


000040 


* 


000040 


* 


000040 


* 


000040 


2 


2 


2 


2! 




054300 


* 


000040 


* 


000040 


* 


000040 


He 


000040 


2 


2 


2 


2 ' 




054310 


* 


000040 


* 


000040 


* 


000040 


* 


000040 


2 


*? 


•y 


2! 




054320 


* 


000040 


* 


000040 


* 


000040 


* 


000040 


2 


2 


2 


2! 




054330 


* 


000040 


* 


000040 


* 


000040 


* 


000040 


2 


o 


2 


2! 




054340 


* 


000040 


* 


000040 


* 


000040 


* 


000040 


*y 


o 


2 


2! 




054350 


* 


170000 


* 


125200 


* 


127542 


* 


000000 


8P^ 


*KH 


.BR 




! p *b/ 


054360 


* 


000004 


* 


130034 


* 


131100 


* 


000110 


n 


.GD 


.T2 


A2! 


! O02H 


054370 


* 


000000 


* 


000000 


* 


000000 


* 


000773 








L*! 


! < 


054400 


* 


111404 


* 


055050 


* 


044000 


* 


000540 


UT6 


NO 


KT2 


H2! 


! <Z H^ 


054410 


* 


121246 


* 


004110 


* 


140046 


* 


000000 


Z 8 


AM 


0/0 




!S"H S0 


054420 


* 


000005 


* 


140111 


* 


000056 


* 


000000 


E 


00Y 


AF 




! 10. 


054430 


* 


000000 


* 


100000 


* 


000000 


* 


053654 




TSH 




NAD! 


! rU 


054440 


* 


000000 


* 


000462 


* 


000000 


* 


100100 




GZ 




TT2! 


! 2 @ 


054450 


* 


000000 


* 


000000 


* 


054452 


* 


000000 






NJZ 




! *Y 


054460 


* 


054456 


* 


000000 


* 


000000 


* 


044256 


NJO 






KYF! 


! .Y .H 


054470 


* 


007754 


* 


000000 


* 


020001 


* 


074000 


BU6 




ED3 


SH ! 


! 1 :■: 


054500 


* 


000062 


* 


117403 


* 


046166 


* 


055174 


AJ 


YQ$ 


LIN 


NSD! 


! 2 vL ! Z 


054510 


* 


000031 


* 


111404 


* 


000000 


* 


000000 


Y 


WT6 








054520 


* 


000031 


* 


047102 


* 


047102 


* 


000000 


Y 


LT4 


LT4 




! BNBN 


054530 


* 


000000 


* 


000000 


* 


054532 


* 


000000 






NK4 




! ZY 


054540 


* 


054536 


* 


000000 


* 


000001 


* 


054462 


NKB 




A 


NJ4! 


!"Y 2Y 


054550 


* 


000000 


* 


001000 


* 


121172 


* 


000172 




L2 


Y94 


CB! 




054560 


* 


053254 


* 


135600 


* 


003777 


* 


003777 


M4. 





AKG 


AKG! 


! »v ; 


054570 


* 


170017 


* 


121442 


* 


121172 


* 


000000 


8P0 


ZDB 


Y94 




! p'tz" 


054600 


* 


000000 


* 


000000 


* 


000000 


* 


000000 












054610 


* 


000000 


* 


000000 


* 


000000 


* 


000000 












054620 


* 


054702 


* 


000001 


* 


000000 


* 


000000 


NNR 


A 






!BY 


054630 


* 


000000 


* 


000000 


* 


000373 


* 


000000 






FK 




! < 


054640 


* 


000000 


* 


000000 


* 


000000 


* 


054744 








NOL! 


! dY 


054650 


* 


000006 


* 


046166 


* 


000000 


* 


046166 


F 


LIN 




LIN! 


! vL vL 


054660 


* 


000000 


* 


046166 


* 


000000 


* 


046166 




LIN 




LIN! 


! vL vL 


054670 


* 


000000 


* 


046072 


* 


000000 


* 


046116 




LG4 




LHN! 


! :l nl 


054700 


* 


000000 


* 


000001 


* 


055174 


* 


120000 




A 


NSD 


YX ! 


! :z 


054710 


* 


123077 


* 


047074 


* 


000031 


* 


000000 


ZW9 


LT. 


Y 




!?8<N 


054720 


* 


000612 


* 


014006 


* 


170000 


* 


122200 


14 


C30 


8P 


ZL2! 


! p $ 


054730 


* 


000060 


* 


000001 


* 


000001 


* 


044336 


AH 


A 


A 


KZN! 


!0 ~H 


054740 


* 


054350 


* 


000000 


* 


000000 


* 


120424 


NI 






Y06! 


!hX ! 


054750 


* 


.1.20502 


* 


000176 


* 


140354 


* 


135600 


Y2B 


CF 


04. 


! 


!B!" ie ; 


054760 


* 


000454 


* 


000454 


* 


17001.7 


* 


121714 


GT 


GT 


8P0 


ZHL! 


! t f PL* 


054770 


* 


120506 


X! 


000000 


* 


000000 


* 


000000 


Y2F 








!F! 


055000 


* 


000000 


* 


000000 


* 


000000 


* 


000000 












055010 


* 


000000 


* 


000000 


* 


055102 


* 


000001 






NQZ 


A! 


! BZ 


055020 


* 


126202 


* 


000000 


* 


000000 


* 


000000 


$XB 








! f 


055030 


* 


000376 


* 


000000 


* 


000000 


* 


000000 


FN 








i ** 


055040 


* 


000000 


* 


055144 


* 


000007 


* 


046072 




NRT 


G 


LG4! 


! dZ : L 


055050 


* 


000000 


* 


042360 


* 


000000 


* 


043630 




KAH 




KRH! 


! pD G 


055060 


* 


000000 


* 


046166 


* 


000000 


* 


046072 




LIN 




LG4! 


! vL ;l 


055070 


* 


000000 


* 


046116 


* 


000000 


* 


046072 




LHN 




LG4! 


! NL : L 


055100 


* 


000000 


* 


000001 


* 


053654 


* 


120000 




A 


NAD 


YX ! 


! rU 


055.1.10 


* 


132277 


* 


046430 


* 


000123 


* 


000000 


.61 


LMP 


BC 




!?4 MS 


055120 


* 


000612 


* 


051006 


* 


170000 


* 


124636 


14 


MD8 


8P 


*EV! 


! R p ) 


055130 


* 


000000 


* 


177777 


* 


044000 


* 


000000 




80 


KT2 




! H 
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M 
-J 
-J 



3 










4 

5 










6 










7 










B 










9 










10 










11 










12 










13 










11 

IS 










16 










17 










113 










.1.9 










20 










21 








> + 


22 










23 000000 










24 










2L=; 










26 










27 000000 


012 


015 


105 


PRMT: 


000003 


116 


124 


105 




000006 


122 


040 


101 




000011 


040 


124 


105 




000014 


122 


115 


111 




000017 


116 


101 


114 




000022 


040 


116 


125 




000025 


115 


102 


105 




000030 


122 


072 


040 




28 


000033 






PLEN 


29 000033 


105 


116 


124 


mesi: 


000036 


105 


122 


040 




000041 


101 


040 


103 




000044 


117 


115 


115 




000047 


101 


116 


104 




000052 


040 


106 


117 




000055 


12^ 


040 


115 




000060 


103 


122 






30 


000027 






LENT1 


31 000062 


116 


125 


115 


MESS1 


000065 


102 


105 


122 




000070 


040 


111 


123 




000073 


040 


116 


117 




000076 


.1.24 


040 


117 




000101 


103 


.1.24 


101 




000104 


114 


054 


040 




000107 


124 


122 


131 




000112 


040 


101 


107 




000.1.15 


101 


1. 1 1 


116 




000120 


041 








32 


000037 






LEN1 



.TITLE DUMP 

THIS TASK ASKS THE USER FOR A TERMINAL NUMBER AND A 
COMMAND LINE. IT THEN PASSES THE COMMAND TO MCR 
AS IF HAD ORIGINATED AT THE SPECIFIED TERMINAL. IT 
PERFORMS THIS TASK BY USING SYSTEM SUBROUTINESr *ALOCB 
AND *QMCRL» TO ALLOCATE A BLOCK FROM POOL AND PASS IT 
TO MCR. 

the task must be built privileged and map to the executive, 
to assemble: 

>mac term=c 1 . 1 -texemc/ml , 1 1 1 , 1 03rsxmc/pa i 1 , c ( your uic ) 3 term 
TO build: 

>TKB TERM/PR : 5==TERM r 1 1 r 54 1RSX1 1M . STB/SS 

.MCALL EXIT$S»CJIOU*SfDCBDF* 
DCBDF* 

TERMINAL MESSAGES 

.ASCII <12><15>/ENTER A TERMINAL NUMBER: / JPROMPT 



CO 
K 

era 
•-3 

3 

o 

S3 

> 

era 
s 
ra 
era 



--PRMT 



.LENGTH OF PROMPT 



.ASCII /ENTER A COMMAND FOR MCR/ 



.--MESI 
.ASCII /NUMBER IS NOT OCTAL, TRY AGAIN!/ 



--MESS1 
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ro 

oo 



33 



34 

35 



36 
37 



38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 



000121 
000124 
000127 
000132 
000135 
000140 
000143 

000144 
000147 
000152 
000155 
000160 
000163 

000166 
000171 
000174 
000177 
000202 
000205 
000210 
000213 
000216 



000220 
000224 
000230 
000232 
000234 
000236 
000240 
000242 
000244 
000246 



000250 
000322 
000374 
000400 
000404 
000406 



000412 
000414 
000416 
000422 
000426 
000432 
000434 



124 
115 
101 
116 
040 
125 
041 

000023 
116 
120 
114 
126 
114 
114 

000022 
111 
040 
122 
040 
040 
115 
116 
111 
125 

000032 



124 
177777 
000000 
000000 
000000 
000000 
000000 
000000 



016703 
012700 
005002 



005702 
001402 
000167 

012700 
011000 
001422 



105 
111 
114 
117 
106 
116 



117 
117 
040 
101 
101 
105 

057 
105 
117 
117 
103 
115 
104 
116 
124 



124 



177626 
000220' 



000436 
000000G 



1 ^^ 

116 
040 
124 
117 
104 



040 
117 
101 
111 
102 
041 

117 
122 
122 
116 
117 
101 
040 
120 



ERMES: .ASCII /TERMINAL NOT FOUND!/ 



ERL = . -ERMES 

POOL! .ASCII /NO POOL AVAILABLE!/ 



PL = .-POOL 

IOERR: .ASCII !I/0 ERROR ON COMMAND INPUT! 



IOL 



buf: 

iosb: 

nam: 

ERRCNT : 

comm: 

place: 

ucb: 

hcb: 

lou: 

high: 



-IOERR 



.EVEN 



PROGRAM DATA 



. BLKB 

.BLK'U 

•ASCII 

.WORD 

.WORD 

. WORD 

. WORD 

.WORD 

.WORD 

.WORD 



/TT/ 
-1 










BEGINNING OF CODE 



TERM : 


QIOW*S 


*I0.WVBr*5r*l 




aiowss 


*I0.RVB>#5»*1 




MOV 


IC)SB+2rR3 




MOV 


*BUF,RO 




CLR 


R2 




CALL. 


*COTB 




TST 


R2 




BEC) 


CONT 




JMP 


ERR1 


cont: 


CALL 


$SWSTK,BACK 




MOV 


#*DEVHDrRO 


li: 


MOV 


< RO ) f RO 




BED 


GO 



(MAKE SURE OF WORD BOUNDARY 



( BUFFER FOR TERMINAL NUMBER 

(I/O STATUS BLOCK 

(TERMINAL NAME 

( ERROR INDICATOR 

( ADDRESS OF COMMAND LINE IN POOL 

( ADDRESS OF POOL BLOCK 

(SAVED UCB ADDRESS 

(SAVED DCB ADDRESS 

(SAVED LOW UNIT NUMBER 

(SAVED HIGH UNIT NUMBER 



,,, , <#PRMT f #PLEN , #40> ( PROMPT 
»>#I0SB»><*BUF>#4> (GET 'TT' NUMBER 
(SAVE CHARACTER COUNT 
(SET UP FOR CALL TO CONVERSION 
( ROUTINE - FROM ASCII TO 
( BINARY<OCTAL> 

( Rl WILL CONTAIN CONVERTED NUMBER 
( R2 WILL CONTAIN TERMINATOR 
(TEST FOR ERROR 
(IF NOT CONTINUE 
(GO TO ERROR ROUTINE 
((SWITCH TO SYSTEM STATE 
((PICK UP LISTHEAD FOR DCB LIST 
((GO TO NEXT DCB 
((IF NONE FINISH UP 



CO 
hS 
CO 
-3 
W 

2 

O 

> 
CO 

EC 
PI 
CO 
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-J 



71 
72 
77, 
74 
75 
76 
77 
78 
79 
BO 
131 
82 
13:5 
(31 
85 
136 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 

:ioo 

101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
1 1 1 
112 
113 
114 
115 
116 
117 
1 1 8 
1.1.9 
120 
121 
122 
123 
124 
125 
126 
127 



000436 
000444 
000446 
000454 
000462 
0004A6 
000470 
000474 
000502 
000504 
000504 
000510 
000512 
000516 
000522 
000526 
000530 

000534 
000540 
000542 
000544 
000550 
000556 
000562 
000566 
000572 
000574 
000600 
000604 
000606 
000606 
000612 
000614 
000620 
000624 
000630 
000634 
000636 
000644 
000652 
000724 
000730 
000734 
001006 
001010 
001014 
001020 
001022 
001026 
001032 
001036 
001044 
001050 
001052 
001052 



026760 
001372 
116067 
116067 
020167 
003361 
010067 
062767 



005767 
001402 
000167 
016700 
016002 
010104 
166704 

016005 
070504 
060502 
010267 
012767 



177566 000004 



000006 
000007 
177560 

177546 
000001 



177522 

000430 
177520 
000002 

177510 

000010 



177470 
177777 



012701 000124 



103404 
005267 
010067 



005767 
001402 
000167 
012700 
016701 
012721 
077003 
016767 
062767 

005067 
005067 

103002 
000167 
105767 
002002 
000167 

016701 
016761 



177432 
177432 



177420 

000406 

000124 
177406 
000040 

177374 
000004 

177274 
177272 



000272 
177204 



000260 



177200 
177176 



177570 
177564 



177530 



go: 
back : 



it: 



177454 



none: 

BACK2: 



i*: 



2*: 



1 77370 
177362 



3*: 



4*: 



ooooo:; 



BACK3 : 



CMP 

bne 

MOVB 

MOVE 

CMP 

BGT 

MOV 

ABB 

RETURN 

TST 
BEQ 
JMP 
MOV 
MOV 
MOV 
SUB 

MOV 

MUL 

ABB 

MOV 

MOV 

CALL 

MOV 

CALL 

BCS 

INC 

MOV 

RETURN 

TST 

BEO 

JMP 

MOV 

MOV 

MOV 

SOB 

MOV 

ABB 

QlOWtS 

CLR 

CLR 

oiowts 

B CL- 
UMP 
TSTB 
BGE 
JMP 
CALL 
MOV 
MOV 
CALL 
RETURN 

EXITtS 



NAM > B . NAM < RO > 

LI 

B.UNIKRO) rLOW 

D.UN1T+KR0) rHIGH 

Rl.HIGH 

LI 

RO j BCB 

#1 » ERRCNT 



ERRCNT 

1* 

ERR2 

BCBjRO 

D.UCB(R0)>R2 

RlfR4 

L0W,R4 

B.UCBL<R0),R5 

R4,R5 

R5»R2 

R2 , UCB 

#-l» ERRCNT 

*SWSTK»BACK2 

*84. >R1 

tALQCB 

NONE 

ERRCNT 

RO > PLACE 



ERRCNT 

It 

ERR3 

*S4.»R0 

PLACE t Rl 

*40, (Rl)+ 

R0»2t 

PLACE rCOMM 

#4,C0MM 

*I0.UVB»*5»#1»f rr<*ME 

IOSB 

IOSB+2 

#I0.RVBr*5,*lrfI0SB»» 

3* 

ERR4 

IOSB 

4t 

ERR 4 

tSWSTK,BACK3 

PLACE »R1 

UCBf2<R1> 

tOMCRL 



if LOOK FOR 'TT' BCB 

(IF NOT 'TT' GET NEXT BCB 

(GET LOW UNIT NUMBER 

J GET HIGH UNIT NUMBER 

iCOMPARE INPUT WITH HIGH 

(IF INPUT LARGER GET NEXT DCB 

fSAVE DCB ABDRESS 

(INDICATE NO ERROR HERE 

( RETURN TO USER STATE 

NOW IN USER STATE 

TEST FOR ERROR 

CONTINUE IF OK 

GO TO ERROR ROUTINE 

GET BCB ADDRESS 

GET ADDRESS OF FIRST UCB 

MOVE FOR CALCULATIONS 

FIND THE NUMBER WITHIN UCBS 
FOR CURRENT DCB 

GET UCB LENGTH 

CALCULATE OFFSET FOR UCB 

CALCULATE BEGINNING OF UCB 

SAVE UCB ADDRESS 

RESET ERROR COUNT 

fSWITCH TO SYSTEM STATE 

(SET BLOCK SIZE 

i ALLOCATE BLOCK FROM POOL 

(NO ROOM IN POOL 

(INDICATE NO ERROR HERE 

(SAVE ABDRESS OF POOL BLOCK 

i RETURN TO USER STATE 
BACK IN USER STATE 
CHECK FOR ERROR 
CONTINUE IF OK 
GO TO ERROR ROUTINE 
SET LENGTH OF BLOCK 
GET ADDRESS OF BLOCK 
PLACE BLANKS IN BLOCK 
LOOP UNTIL THROUGH 
CALCULATE LOCATION OF COMMAND 
LOCATION IN BLOCK- 
SI >#LENTlr#40> (PROMPT FOR COMMAND 
CLEAR THE I/O STATUS - WORD 1 
- WORD 2 

;C0MM,#80.> f INPUT COMMAND 
CONTINUE IF OK 
BRANCH IF CIIO ERROR 
CHECK FOR I/O ERROR 
CONTINUE IF OK 
BRANCH IF ERROR 
(SWITCH TO SYSTEM STATE 
fGET ADDRESS OF BLOCK 
(PLACE UCB ADDRESS IN BLOCK 
(QUEUE BLOCK TO MCR 
(LEAVE SYSTEM STATE 
BACK IN USER STATE 
EXIT 



k: 
en 
>-3 

P3 

3 

o 

> 
CD 
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M 
CO 
Si 





MACRO M1200 01 


-NOV -81 


128 








129 








130 


001060 






1131 


001132 


012700 


000220 


132 


001136 


005020 




133 


001140 


077302 




134 


001142 


000167 


177102 


133 








136 








137 








138 


001146 






139 


00.1220 






140 








141 








142 








143 


001226 






144 


001300 






145 








146 








147 








148 








149 


001306 






150 


001360 






151 


00.1364 


016700 


176646 


152 


001370 


012701 


000124 


153 


001374 






154 


001400 






155 


001402 






156 


001402 






157 




000250' 
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r 


ROUTINE 


i 

erri: 


QlOWtS 




MOV 


CLEAR { 


CLR 




SOB 




JMP 




ROUTINE 


ERR2 : 


OI0W$S 




EXIT$S 




ROUTINE 


ERR3 : 


QIOU*S 




EX.TT*S 




ROUTINE 




THE POOl 


ERR4{ 


QlOWtS 




CALL 




MDV 




MOV 




CALL 




RETURN 


FIN! 






EXIT*S 




.END 



TO HANDLE BAD TERMINAL NUMBER 

*I0.WVBf*5f*1ff , f<*MESS1f#LEN1f#40> {PRINT MESSAGE 
♦BUFfRO J GET INPUT BUFFER ADDRESS 

<R0)+ (CLEAR BUFFER 

R3f CLEAR SR3 CONTAINS CHARACTER COUNT 

TERM STRY AGAIN 



SPRINT MESSAGE 



SPRINT MESSAGE 



TO HANDLE NON-EXISTENT TERMINAL 



*I0 . UVB f #5 f *1 f f f f <#ERMES f #ERL f #40> 

SEXIT 



TO HANDLE POOL ALLOCATION FAILURE 



*I0 . WVBf #5 f #1 F F f f <#POOL f #PL f #40> 

SEXIT 



TO HANDLE I/O ERRORS ON COMMAND INPUT 
BLOCK MUST BE DEALLOCATED! 



*I0.UVBf#5f#1f f f f<*I0ERRf#I0Lf#40> 
*SWSTKfFIN SSSWITCH TO SYSTEM STATE 

PLACE fRO SSGET ADDRESS OF BLOCK 

*84.fR1 SSSET BLOCK LENGTH 

tDEACB SS DEALLOCATE BLOCK 

ff LEAVE SYSTEM STATE 
SBACK IN USER STATE 
SEXIT 
TERM 



SPRINT MESSAGE 



co 

K 
CO 
•"3 
W 

3 

O 

> 
CO 
EC 

CO 



Example 10-10 Listing of Task TT2 (DUMP) 
(Sheet 4 of 5) 



to 
oo 



DUMP 


MACRO Mi: 


:>00 01 -NOV -81 


ll.'OV PAGE 3- 


.4 












SYMBOL 


TABLE 


















A**BIO 


■ 000000 


D.MSK 


000014 


K**IEN= 


000113 


PRMT 


OOOOOOR 


T$»BTU= 


000000 


A**BRT = 


■ 000000 


B. NAM 


000004 


K**L.DC= 


000144 


P**BPR= 


000063 


T»$BUF= 


000000 


A**CHK = 


= 000000 


D . PCB 


000034 


K**TPS- 


000144 


P**CTL= 


000000 


T*tCCA--' 


000000 


A$*(;i.I = 


= 000004 


II . UCB 


000002 


LDtCO = 


000000 


P**FRS= 


000310 


T*$CCO= 


000000 


A»*CPS=- 


= 000000 


n.UCBL 


000010 


LD*DD = 


000000 


P**QMX= 


000000 


T»*CPW= 


000000 


A*»N!3I = 


■- 000000 


D.UNIT 


000006 


LD*DK = 


000000 


P**HIL= 


003100 


T**CTR=' 


000000 


A**PR1'=- 


' 000000 


Ii . VCAN= 


000002 


LD*DL - 


000000 


P**LAS= 


000000 


T*«CUP= 


000000 


A»$TRP= 


'. 000000 


D.VDEB" 


177776 


LB*DM = 


000000 


P*$LOL= 


001130 


T»»C11= 


000001 


BACK 


00 05 04 R 


D.VINI= 


000000 


LB* BR = 


000000 


Pt*OFF= 


000000 


T*$ESC= 


000000 


BACKS 


000606R 


D.VOUT- 


000004 


LD«DS = 


000000 


P$*P45= 


000000 


T**GMC= 


000000 


BACK3 


00.1.052R 


D.VPUF™ 


000006 


LD*DT = 


000000 


P**RFL- 


000000 


T$*GTS= 


000000 


BUF 


000220R 


ERL 


000023 


LDtLP = 


000000 


P**RTY= 


000000 


T»*HFF= 


000000 


B*»LV1= 


030463 


ERMES 


000121R 


l.D*MM ■= 


000000 


P$»SRF= 


000000 


T*»HLD- 


000000 


B$*LV2= 


■ 020040 


ERRCNT 


000232R 


LDtTT = 


000000 


Q**OPT= 


000005 


T*$J16~ 


000001 


CLEAR 


001136R 


ERR1 


001060R 


LENT1 = 


000027 


R**DER= 


000000 


T**KMG= 


000000 


CO MM 


000234R 


ERR2 


001146R 


LEN1 - 


000037 


R**EXV" 


000000 


T*$LWC= 


000000 


CO NT 


000422R 


ERR3 


- 001226R 


LOU 


000244R 


R**JS1= 


000001 


T**REB= 


000000 


C*»CBA= 


000002 


ERR4 


001306R 


L$*ASB= 


000000 


Rt*Kll= 


000001 


Tt*RNE= 


000000 


C»»CHE'= 


000000 


E»*ACT= 


000000 


L$*DRV= 


000000 


R**LKL= 


000001 


T*»RPR= 


000000 


c:**CKP= 


000004 


E**DVC= 


000000 


L**LDR= 


000000 


R**Lil= 


000001 


T$*RST= 


000000 


c;**csr= 


177404 


E**L06= 


000000 


L*$PTO= 


000036 


R**MOF= 


000000 


T*»RUB= 


000000 


<::**int= 


000000 


E**XPR= 


000000 


L*»P11= 


000001 


R**M11= 


000001 


T**SMC= 


000000 


C»*ONS= 


000001 


FIN 


001402R 


LI 


000432R 


R$*NDC= 


000005 


T**SYN= 


000000 


C**ORE" 


002022 


F**L.PP= 


000000 


MESS1 


000062R 


R»*NDH= 


000226 


TttTRW= 


000000 


C«»OTM= 


000000 


F*$LVL= 


000001 


MES1 


000033R 


R**NBL= 


000001 


Tt*UTB= 


000000 


C**RSM" 


177564 


GO 


000502R 


M*tCRB= 


000124 


R**POI= 


000000 


T*tUTO= 


000170 


C**RUN= 


000000 


G**EFN= 


000000 


M«*CRX= 


000000 


R*»SNB= 


000000 


T$*U58= 


000001 


c:**smt= 


000000 


G**TPP-= 


000000 


M**EIS" 


000000 


R**11M= 


000000 


T**VBF= 


000000 


C**TTY" 


177564 


G$*TSS= 


000000 


Mt*EXT= 


000000 


R**60F= 


000000 


T**30P= 


000000 


DCB 


000242R 


G»*TTK= 


000000 


M**FCS= 


000000 


R**611= 


000001 


UCB 


000240R 


I.1»$H11 = 


000001 


HIGH 


000246R 


M**MGE=< 


000000 


S*$ECC= 


000000 


IJ**MHI = 


000000 


IJ«*IAG = 


000000 


H**RTZ= 


000074 


M$*MUP= 


000000 


S**NM1~ 


051522 


U*tMLO- 


160000 


D**.TSK= 


000000 


IOERR 


000166R 


M*$OVR=* 


000000 


S**NM2= 


030530 


U«»MRN= 


170234 


I)»*Lii« 


000002 


IOL 


000032 


NAM 


000230R 


S**NM3= 


046461 


V**CTR= 


000400 


OT*Ml:I== 


000001 


IOSB 


000224R 


NONE 


000604R 


S**TIM= 


000000 


V*«RSN~ 


000040 


D*$PAR== 


000000 


IO.RVB=< 


****** GX 


N**LBV= 


000001 


S»*TOP= 


000000 


X*»DBT-= 


000000 


D**SHF« 


000000 


IO.UUB- 


****** GX 


N**MOV= 


000041 


S»*WLK= 


000000 


tALOCB-- 


****** GX 


D**WCK== 


000000 


I**RAR== 


000000 


N**UMR= 


000034 


S**UPC= 


000036 


»COTB = 


****** GX 


D**YNC= 


000000 


I**RDN== 


000000 


PL 


000022 


S**WPR= 


000005 


*DEACB~ 


****** GX 


D**YNM-~ 


000000 


K**AST= 


000000 


PLACE 


000236R 


S»«YSZ= 


022000 


♦DEVHD» 


****** GX 


D.DSP 


000012 


K**CNT= 


172542 


PLEN = 


000033 


TERM 


000250R 


*OMCRL= 


%%%%%% GX 


D.LNK 


000000 


K**CSR--- 


172540 


POOL 


000144R 


T**ACR= 


000000 


***ARG= 


000002 


. ABS. 


000036 
001410 


000 
001 
















ERRORS : 


detected: 




















en 
•-3 
w 
3 

O 

> 
w 
EC 

a 
en 



VIRTUAL MEMORY USED! 10113 WORDS ( 40 PAGES) 
DYNAMIC MEMORY: 16120 WORDS < 62 PAGES) 

ELAPSED time: oo:oo:i3 

DUMP , DUMP/ - -SP = L 1 t 1 :iEXEMC/ML , C 1 1 , 103RSXMC/PA : 1 r 17 , 377JBUMP 



Example 10-10 Listing of Task 
(Sheet 5 of 5) 



TT2 (DUMP) 



00 



DUMP.TSK Memory allocation hsp TKB M39.7D Pssfe 1 

1-N0V-81 11509 

Partition name 5 GEN 

Identification t M4.0 

Task U.TC t 17,3771 

Stack limits: 120172 121171 001000 00512. 

f-RG ;:fr address! 121442 

Task attributes: PR 

Total address windows: 1. 

Task ima^e size : 800. words 

Task address limits: 120000 123007 

R--W disk blk limits? 000002 000005 000004 00004. 

##* Root segment? DUMP 

R/W mem limits? 120000 123007 003010 01544. ™ 

Disk blk limits? 000002 000005 000004 00004. ^ 

Memory allocation synopsis: 

O 
Section Title I dent File 50 

> 
cn 



M . BLK.?<RWfI»LCLfRELfC0N> 121172 001504 00836. 5C 

121172 001410 00776. DUMP M4.0 DUMP. OBJ f 2 M 

**RESL?<R0»IfLCL.fRELfC0N) 122676 000112 00074. W 

Global symbols? 

10. RUB 010400 I0.WVB 011000 $AL0CB 011346 $DEACB 011614 *DEVHD 010046 *QMCRL 021432 



4 $4 Task builder statistics: 

Total work file references? 850. 

Work file reads: 0. 

Work file; writes: 0. 

Size of core pool: 20506. words (80. P33es) 

Size of work file? 768. words (3. psaes) 



E 1 spsed t i me : 00 : 00 : 04 

Example 10-11 Map of Task TT2 



SYSTEM CRASHES 



RSX-11M CRASH DUMP ANALYZER 
TASK DUMP 



Y4.0 



1-N0V-81 



11:39 



PAGE 9 



TASK DUMP OF TT2 



TCB ADDRESS = 054440 



HEADER ADDRESS 



054* 



window blocks: 
par virt limits att desc wnd size offset 1st pdr no. last pdr 

GEN 120000 123077 047074 000031 000000 177612 1 014006 



WINDOW #1 


— TASK VIRTUAL LIMITS 12 


0000-123077 












PHYSICAL 


STARTING 


ADDRESS 


= 00440400 












120000 


000000 


000172 


053254 


135600 




CB 


M4, 


! 


! 2 ,y i 


120010 


003777 


003777 


170017 


121442 


AKG 


AKG 


8P0 


ZDB! 


! r-"# 


120020 


121172 


000000 


000000 


000000 


Y94 








1 T B 


120030 


000000 


000000 


000000 


000000 












120040 


000000 


000000 


054702 


000000 






NNR 




! BY 


120050 


000000 


000000 


000000 


000000 












120060 


000000 


000000 


000000 


000000 












120070 


000000 


054744 


000006 


046166 




NOL 


F 


LIN! 


! dY vL 


120100 


000000 


046166 


000000 


046166 




LIN 




LIN! 


! vL vL 


120110 


000000 


046166 


000000 


046072 




LIN 




LG4! 


! vL :l 


120120 


000000 


046116 


000000 


000001 




LHN 




A! 


! NL 


120130 


115274 


120000 


123077 


000000 


XOL 


YX 


ZW9 




!< ?S 


120140 


000031 


000000 


000612 


014006 


Y 




14 


C30! 




120150 


004070 


000001 


000000 


135600 


ALX 


A 




! 


!8 } 


120160 


053254 


000000 


100100 


000000 


M4. 




TT2 




} ,K> & 


120170 


000000 


000000 


000000 


000000 













CABOVE LINE REPEATED 60. TIMES3 



121140 


000000 


006003 


0.10400 


000005 


1 


A65 


B.2 


E! 


; | 


121150 


000001 


000000 


000000 


054104 


! A 






ND6! 


! DX! 


121160 


000120 


000000 


000000 


000000 


! B 






! 


!P ! 


121170 


000000 


006412 


047105 


042524 


1 


BCR 


LT7 


KC. ! 


! ENTE ! 


121200 


020122 


020101 


042524 


046522 


!EF4 


EFQ 


KC. 


LN4! 


!R A TERM! 


121210 


047111 


046101 


047040 


046525 


!LUA 


LHA 


LT 


LN7! 


IINAL NUM! 


121220 


042502 


035122 


042440 


052116 


!KCJ 


IMJ 


KBP 


MSV! 


!BER: ENT! 


121230 


051105 


040440 


041440 


046517 


!MFU 


JP2 


J/X 


LN1 ! 


!ER A COM! 


121240 


040515 


042116 


043040 


051117 


! JQ7 


J7F 


KH2 


MF1! 


!MAND FOR! 


121250 


046440 


051103 


052516 


041115 


!LMX 


MFS 


MY8 


JXM! 


! MCRNUMB! 




Example 


10-12 


CDA of 


Task 


TT2 














(Sheet 


1 Of 4) 













283 



SYSTEM CRASHES 



Rsx-iiM crash dump 

TASK DUMP 



ANALYZER 



V4.0 



i-N0y-81 



li:39 



PAGE 10 



121260 
121270 
121300 
121310 
121320 
121330 
121340 
121350 
121360 
121370 
121400 
121410 
121420 
121430 
121440 
121450 
121460 
121470 
121500 
12.1510 
121520 
121530 
121540 
121550 
121560 
121570 
12.1600 
121610 
121620 
121630 
121640 
121650 
121660 
121670 
121700 
121710 
121720 
121730 
121740 
121750 
121760 
121770 
122000 
122010 
.1.22020 
122030 
122040 
122050 
122060 
122070 
122100 
122110 
122120 
122130 
122140 
122150 



05.1105 
020124 
052040 
047111 
040516 
047506 
050040 
044501 
027511 
020122 
040515 
052125 
000000 
054100 
000021 
012746 
012746 
005046 
000005 
006003 
005046 
012746 
121416 
012746 
012746 
177626 
004767 
000167 
012700 
026760 
116067 
000007 
003361 
000001 
177522 
016700 
010104 
0000.1.0 
177470 
104376 
004767 
177432 
005767 
000406 
177406 
016767 
000004 
005046 
000027 
005046 
012746 
012746 
177274 
005046 
000120 
016746 



044440 
041517 
054522 
052041 
020114 
047125 
047517 
040514 
020117 
047117 
042116 
000063 
052124 
044336 
005046 
000040 
121172 
112716 
012746 
104377 
005046 
121412 
005046 
000005 
006003 
012700 
001004 
000436 
010046 
177566 
000006 
177564 
010067 
177530 
001402 
177520 
166704 
070504 
012767 
122000 
067362 
010067 
177420 
012700 
0.1.2721 
177374 
177362 
012746 
012746 
005046 
000005 
006003 
005067 
005046 
016746 
177242 



020123 
040524 
040440 
051105 
047516 
020504 
020114 
046102 
051105 
041440 
044440 
000000 
000000 
044212 
005046 
012746 
005046 
000001 
0.11000 
005046 
012746 
005046 
112716 
012746 
104377 
121412 
005702 
104376 
011000 
000004 
177570 
020167 
177546 
000207 
000167 
016002 
177510 
060502 
177777 
01270.1 
103404 
177432 
001402 
000124 
000040 
177370 
005046 
000040 
121225 
112716 
012746 
104377 
177272 
005046 
177260 
005046 



047516 
026114 
040507 
044515 
020124 
047516 
053101 
020505 
047522 
046517 
0501.1.6 
000000 
054104 
000002 
005046 
000033 
005046 
012746 
012746 
005046 
000004 
012746 
000001 
010400 
016703 
005002 
001402 
121676 
001422 
001372 
116067 
177560 
062767 
005767 
000430 
000002 
016005 
010267 
177454 
000124 
005267 
000207 
000.167 
016701 
077003 
062767 
005046 
012746 
005046 
000001 
011000 
005067 
005046 
012746 
005046 
1.12716 



MFLJ 


K. 


EF5 


EF6 


J01 


JRD 


MRP 


NKZ 


JP2 


LUA 


MRG 


MFU 


JQ8 


EF. 


L*V 


L*N 


LUM 


EL. 6 


L22 


L*U 


EF. 


K.3 


JQ6 


LHB 


GUY 


EF1 


MFU 


EF4 


LUG 


J/X 


JQ7 


J7F 


K, 


MS/ 


AK 
MS. 




ND2 


KZN 


KXJ 


Q 


AX8 


AX8 


CTF 


r> 


CTF 


CTF 


Y94 


AX8 


AX8 


W80 


A 


E 


CTF 


B5H 


A65 


U61 


AX8 


AX8 


AX8 


CTF 


CTF 


ZCR 


AX8 


ZCM 


AX8 


U80 


CTF 


E 


CTF 


CTF 


A65 


U61 


50 


CSH 


ZCR 


AU1 


L.6 


A5J 


B9 


GF 


U60 


CSH 


BUN 


B5H 


GN 


48 


D 


X91 


F 


5 


G 


46 


EG1 


ADO 


BUI 


4V 


A 


4H 


CO 


4B 


SJ 


B9 


BOP 


4 


DSJ 


BXD 


8A. 


32 


H 


RD6 


OYR 


3P 


CTW 


80 


U60 


ZIX 


CSI 


AUI1 


QOB 


UXD 


2Z 


BUI 


2Z 


A6UI 


2P 


SJ 


FV 


CSH 


BD 


2F 


CSY 


J :> 


Dll 


16 


12 


D 


1Z 


AX8 


AX8 


CTF 


2 


W 


CTF 


Z U 


AX8 


AX8 


U80 


CTF 


E 


CTF 


CTF 


A65 


U61 


OL 


A YD 


0,.) 


AX8 


AX8 


AX8 


B 


DIN 





DIN 


/Z 


AX8 



L*V 
GCT 
JQ.1 
K/E 
EF6 
L*V 
M2A 
EL7 
L*Z 
L.N1 
L.38 

ND6 

B 

AX8 

AX8 

CTF 

CTF 

AX8 

D 

CTF 

A 

B.2 

DOS 

AXB 

SJ 

ZG8 

SZ 

SB 

X91 

42 

PL.W 

A6U 

G 

B 

DSM 

BZ9 

3D 

BD 

A.U 

CO 

B9 

DOQ 

TFS 

PLU 

AX8 

CTF 

AX8 

A 

B5H 

AYO 

AX8 

CTF 

AX8 

U80 



ER IS NO 
T OCTAL , 

TRY AGA 
IN! TERM I 
NAL NOT 
FOUND ! NO 

POOL AU 
AIL ABLE! 
I/O ERRO 
R ON COM 
MAND INP 
UT3 

TT DX 
0X"H H 
X X X 



f 

f z' 
X N 



f 
X 
f 

#X 
*X N 



X % 
f 






i 


f 


V z 


7 


;•: 7 




t w p 


a 


7 f we 




X w 


R 


u 


(? 


P 


D 


DmH 




D«Ba7 


8 


W r 


jV 


*A T 


u 


rn 7 




7 


u 


u 




& T A 




Q 


u 


!"x"we 




r"X X 


% 


f f 




f "X 


% 


X N 


f 


f 


f 


7 


<"7 l"% 


% 


X 8 f 


P 


f 0"X 


f 


'"% N 



Example 10-12 CDA of Task TT2 
(Sheet 2 of 4) 
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SYSTEM CRASHES 



RSX-11M CRASH DUMP ANALYZER 
TASK DUMP 



V4.0 



1-N0V-81 



11:39 



PAGE 11 



122160 
122170 
122200 
122210 
122220 
122230 
122240 
122250 
122260 
122270 
122300 
122310 
122320 
122330 
122340 
122350 
122360 
122370 
122400 
122410 
122420 
122430 
122440 
122450 
122460 
122470 
122500 
122510 
122520 
122530 
122540 
122550 
122560 
122570 
122600 
122610 
122620 
122630 
122640 
122650 
122660 
122670 
122700 
122710 
122720 
122730 
122740 
122750 
122760 
122770 
123000 
123010 
123020 
123030 
123040 
123050 



000001 
010400 
103002 
177204 
104376 
016761 
077170 
104377 
012746 
012746 
005046 
000005 
006003 
005020 
005046 
000040 
121313 
112716 
0.12746 
104377 
005046 
000040 
121336 
112716 
012746 
104377 
005046 
000040 
121360 
112716 
012746 
104377 
176646 
067022 
104377 
012702 
005001 
001774 
162705 
010004 
010400 
116002 
012746 
006001 
005316 
000020 
006101 
005200 
022626 
010546 
012603 
000000 
000000 
000000 
000000 
000000 



012746 
012746 
000167 
002002 
122244 
177176 
000207 
005046 
000040 
121254 
112716 
012746 
104377 
077302 
005046 
012746 
005046 
000001 
011000 
012746 
005046 
012746 
005046 
000001 
011000 
012746 
005046 
012746 
005046 
000001 
011000 
104376 
012701 
000207 
012702 
0000.1.0 
112005 
122705 
000060 
010200 
060501 
177777 
000021 
103002 
003371 
010146 
020116 
005366 
000207 
016605 
012604 
000000 
000000 
000000 
000000 
000000 



000005 
006003 
000272 
000167 
016701 
000002 
012746 
005046 
012746 
005046 
000001 
011000 
012700 
000167 
005046 
000023 
005046 
012746 
012746 
000463 
005046 
000022 
005046 
012746 
012746 
000463 
005046 
000032 
005046 
012746 
012746 
122574 
000124 
012746 
000012 
004567 
122705 
000011 
120502 
004767 
112005 
000207 
005000 
066600 
000415 
005001 
103402 
000002 
010446 
000006 
012605 
000000 
000000 
000000 
000000 
000000 



012746 
104377 
105767 
000260 
177200 
004767 
000463 
005046 
000037 
005046 
012746 
012746 
121412 
177102 
012746 
012746 
005046 
000005 
006003 
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Example 10-12 CDA of Task TT2 
(Sheet 3 of 4) 
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SYSTEM CRASHES 



RSX--11M CRASH DUMP ANALYZER V4.0 1-N0U-81 11 J 39 PAGE 12 
TASK HUMP 

123060 000000 000000 000000 000000 ! ! ! ! 

123070 000000 000000 000000 000000 ! ! ! ! 



TEND OF ANALYSIS OUTPUT] 



Example 10-12 CDA of Task TT2 
(Sheet 4 of 4) 
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DIRECTIVE PROCESSING 



INTRODUCTION 

Many tasks require activities, such as I/O, which cannot be 
easily performed within a user task. To provide the facilities 
for these activities without requiring privileged tasks and 
extensive knowledge of the inner workings of the operating system, 
RSX-11M provides a set of system services called Executive 
directives. 

Executive directives provide a simple interface to these 
services. This interface is through system macros for the 
MACRO-11 programmer and system subroutines for the FORTRAN 
programmer. The interface also provides a completion code for 
error checking. 



OBJECTIVES 

1. List the steps in processing an Executive directive. 

2. Perform the steps necessary to add a user written directive to 
the system. 

RESOURCES 

1. RSX-11M System Lists and Data Structures 

2. RSX-11M/M-PLUS Executive Reference Manual 
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THE USER TASK INTERFACE 

• MACRO-ll task uses macros to invoke directives 

• Three types of macros 

$-form 

$C-form 

$S-form 

• FORTRAN tasks call subroutines 

• Directive Parameter Block (DPB) used to pass data to system 

• Result of directive execution indicated by 

Directive Status Word (DSW) 

Processor Status Word 

Set to indicate failure 
Clear to indicate success 

Directive Parameter Block 

• Data structure contained within the user task 

• Contains parameters needed to execute the directive 

Directive identification code (DIC) 

Other parameters as needed 

Length depends on DIC, can be variable 

• Location of DPB 

In task data area 

In user selected PSECT 
In PSECT $DPB$$ 

On task stack 

• Directive identification code always odd whole number 
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SP 



BLANK 
PSECT \ 



$DPB$$ 
PSECT 



ADDRESS OF DPB IEVEN VALUE) 



DPB: SDAT$ 

[DPB FDR DIRECTIVE] 



DIRS «DPB 



1 



TASK 
HEADER 

TASK 
STACK 



> DATA AREA 



< 



} CODE 



Figure 11-1 Directive Macros: '$' Form 



SP- 
DPB 



BLANK 
PSECT 



$DPB$$ 
PSECT 



DPB SIZE AND PIC (ODD VALUE) 



SDATSS 



TASK 
HEADER 



TASK 
STACK 



DATA AREA 
CODE 



Figure 11-1 Directive Macros: '$S' Form 
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SP 



BLANK 
PSECT 



$DPB$$ 
PSECT 



ADDRESS OF DPB IEVEN VALUE) 



SDATSC 



[DPB FOR DIRECTIVE] 



•s 



< 



TASK 
HEADER 

TASK 
STACK 



DATA AREA 



CODE 



Figure 11-1 Directive Macros: '$C' Form 



293 



DIRECTIVE PROCESSING 



•$• FORM 



SEND: SDAT$ TASKB,BUF,5 



DIR$ #SEND,ERR 



SEND: 



.BYTE 


71. ,5 


.RAD50 


/TASKB/ 


.WORD 


BUF 


.WORD 


5 


MOV 


#SEND,-(SP) 


EMT 


377 


BCC 


.+6 


JSR 


PC, ERR 



' $C FORM 



$$$ 



SDAT$C TASKB , B UF, 5, PROG 1, ERR 



.PSECT 


$DPB$$ 


.BYTE 


• 

71. ,5 


.RAD 50 


/TASKB/ 


.WORD 


BUF 


.WORD 


5 


.PSECT 


PROG1 


MOV 


#$$$,-(SP) 


EMT 


377 


BCC 


.+6 


JSR 


PC , ERR 



' $S' FORM 



TASKB: .RAD50 /TASKB/ 



TASKB: 



.RAD50 /TASKB/ 



SDAT$S #TASKB,#BUF,#5,ERR 



MOV 


#5,-(SP) 


MOV 


#BUF,-(SP) 


MOV 


TASKB+2,-(SP) 


MOV 


TASKB,- (SP) 


MOV 


(PC) + f -(SP) 


.BYTE 


71. ,5 


EMT 


377 


BCC 


.+6 


JSR 


PC, ERR 



Example 11-1 Macro Expansions for SEND DATA 
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DPB SIZE 
IN WORDS 



DIC 



PARAMETER 1 



PARAMETER 2 



PARAMETER N 



Figure 11-2 The Directive Parameter Block 
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Directive Status Word 

• Executive returns a status code in the DSW 

• In general , success is denoted by a status of +1 

• The Set/Clear Event Flag directives use 

to indicate success and flag clear 
2 to indicate success and flag set 

• An error is indicated by a negative status 

• Value stored at location $DSW in the task header 
(in task region) 

• In FORTRAN, value returned in calling argument 
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THE DIRECTIVE DISPATCHER 

• EMT trap causes entry to module DRSUB at $EMTRP 

• Module DRDSP is mapped using KERNEL APR5 and control passes to 
module DRDSP at $DRDSP 

• Routine $DRDSP distinguishs between directive calls, calls to 
$SWSTK and non-RSX EMT traps 

• For directive calls 

KERNEL APR6 is used to map 

WDB or RDB if PLAS directive 
DPB otherwise 

Directive processing routine is called 

• To process a request to switch to kernel mode, a jump to the 
Executive routine $SWSTK is executed 

• For non-RSX EMT traps, a jump to $EMSST in SSTSR is executed 

The Directive Dispatch Table 

• Contains entry for each directive 

Address of service routine 

'Flags byte' 

Length in words (For variable length = 0) 

• Assembled in one of two possible forms 

Single table form 

Two words per possible directive 

Double table form 

One byte per possible directive 
Two words per existing directive 

• The form which uses the least space is automatically chosen 

If less than 75 percent of directives exist, use the two 
table structure 

If 75 percent or more of the possible directives exist, 
use the one table structure 
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QIO$ 

OIOW$ 

GLUN$ 

ALUN$ 

ALTP$ 

RQST$ 

UNUSED 

UNUSED 

RUNS 

UNUSED 

SRRA$ 

MRKT$ 



QIO$ 

QIOW$ 

GLUN$ 

ALUN$ 

ALTP$ 

RQST$ 

UNUSED 

UNUSED 

RUNS 

UNUSED 

SRRA$ 

MRKT$ 

CSRQ$ 

CMKT$ 

EXST$ 

CLEFS 

SETFS 



1. 


ADDRESS OF SDRQIO 




FLAGS BYTE DPB LENGTH 


3. 


ADDRESS OF $DRQIO 




FLAGS BYTE I DPB LENGTH 


5. 


ADDRESS OF $DRGLI 




FLAGS BYTE DPB LENGTH 


7. 


ADDRESS OF SDRASG 




FLAGS BYTE | DPB LENGTH 


9. 










11. 


ADDRESS OF $DRREQ 




FLAGS BYTE DPB LENGTH 


13. 










15. 










17. 


ADDRESS OF $DRRUN 




FLAGS BYTE ! DPB LENGTH 


19. 







I 


21. 


ADDRESS OF $DRRRA 




FLAGS BYTE ! DPB LENGTH 


23. 


ADDRESS OF $DRMKT 




FLAGS BYTE I DPB LENGTH 







TABLE 1 



Single Table Form 



TABLE 2 



2. 

4. 

6. 

8. 
10. 
12. 
14. 
16. 
18. 
20. 
22. 
24. 
26. 
28. 
30. 
32. 
34. 
36. 
40. 
42. 
44. 
46. 
50. 
52. 



1. 


2. 


► 


ADDRESS OF SDRQIO 


3. 


6. 




FLAGS BYTE I DPB LENGTH=12. 


5. 


10. 


ADDRESS OF SDRQIO 


7. 


14. 


FLAGS BYTE I DPB LENGTH=12. 


9. 





ADDRESS OF $DRGLI 


11. 


18. 


FLAGS BYTE I DPB LENGTH=3. 


13. 





ADDRESS OF $DRASG 


15. 





FLAGS BYTE I DPB LENGTH=4. 


17. 


22. 


ADDRESS OF $DRREQ 


19. 







FLAGS BYTE I DPB LENGTH=7. 


21. 


26. 


ADDRESS OF $DRRUN 


23. 


30. 




FLAGS BYTE [ DPB LENGTH=1 1. 


25. 


34. 


ADDRESS OF $DRRRA 


27. 


38. 


FLAGS BYTE I DPB LENGTH=2. 


29. 


42. 


ADDRESS OF $DRMKT 


31. 


46. 


FLAGS BYTE I DPB LENGTH=5. 


33. 


50. 









2. 

4. 

6. 

8. 
10. 
12. 
14. 
16. 
18. 
20. 
22. 
24. 
26. 
28. 
30. 
32. 



Double Table Form 



Figure 11-3 The Directive Dispatch Table 
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YES 



ADDRESS CHECK 
RDB/WDB 





NO 




YES 



CONVERT 
EVENT FLAG 



NO 




YES 



( CALL ROUTINE J 



Figure 11-4 Processing in DRDSP 
(Sheet 1 of 2) 
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c 



ERROR 



NO 



£ 



YES 



CALL 
SSRSTD 




YES 



RO=TCB 

ADDRESS OF 

CURRENT TASK 




SPECIFIED? 



NO 



O 



R1=TASK 
STATUS WORD 



I CALL ROUTINE I 




Figure 11-4 Processing in DRDSP 
(Sheet 2 of 2) 
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DIRECTIVE PROCESSING ROUTINES 
The Interface 

• Directive processing routine is called with registers loaded 
as in Table 11-1 

• Flag byte in directive dispatch table determines processing 

ACHKDB - Address PLAS definition block 

CEFNCL - Convert the event flag 

GEFUSE - Do not increment group global use count 

CEFNMT - Event flag must be specified 

DFCTSK - Task name defaults to current task 

MUPCHK - Perform multi-user protection check 

SRSTCL - Call $SRSTD to find TCB in STD 

• Bits set in flag byte determine contents of R0 and Rl 

If CEFNCL specified 

R0 - Event flag mask word 
Rl - Address of event flag 

If SRSTCL specified 

R0 - TCB address of specified task 
Rl - Address of status word in TCB 
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Table 11-1 Register Usage 

Register Contents 

R5 Address of the TCB of the current task 

R4 Address of the header of the current task 

R3 Address of the next word in the DPB 

R2 Address of the second task status word of 

the current task 

Rl Depends on directive 

R0 Depends on directive 
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The Directive Commons 

• Most directive processing code removed from Executive 

Increases available DSR 

• Two directive commons, EXC0M1 and EXC0M2 

Existence of commons determined at SYSGEN 

Kernel I-space APR 5 used to map directive commons 

Location of processing routine indicated by low order bit 
of address of routine in DDT 

• Module DRSUB 

Is in the Executive 

Always mapped 

Contains the location $EMTRP 

Calls $DIRSV 

Maps to DRDSP which is in EXC0M1 

Contains coroutines $MPXC1 and $MPXC2 which are 

used to map EXC0M1 and EXC0M2 
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KERNEL ACTIVE 
PAGE REGISTERS 



APR#7 



APR#6 



APR#5 



APR#4 



APR#3 



APR#2 



APR#1 



APR#0 




I/O PAGE 



USER TASK 
~~ DPB" ~~ 



EXCOM2 



EXCOM1 



EXECUTIVE 



EXECUTIVE MAPPING 

Figure 11-5 The Directive Commons: Standard Executive Mapping 
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KERNEL ACTIVE 
PAGE REGISTERS 



APR#7 



APR#6 



APR#5 



APR#4 



APR#3 



APR#2 



APR#1 



APR#0 




I/O PAGE 



USER TASK 
- - ppg- - 



EXCOM2 



EXCOM1 



EXECUTIVE 



Figure 11-5 The Directive Commons: Mapping to Reference EXCOM1 
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Table 11-2 Directive Processing Modules 



Module 

DRABO 
DRASG 
DRATP 
DRATX 
DRCIN 
DRCLI 
DRCMT 
DRDAR 
DRDCP 
DRDSP 
DREIF 
DREXP 
DRGCL 
DRGEF 
DRGLI 
DRGPP 
DRGSS 
DRGTK 
DRGTP 
DRMAP 

DRMKT 
DRPUT 
DRQIO 
DRRAS 
DRREG 
DRRES 
DRSED 

DRSMG 
DRSPW 
DRSST 
DRSUB 



Location 

EXCOM1 

EXCGM2 

EXCOM2 

EXCOM1 

EXCOM2 

EXCOMI 

EXCOMI 

EXCOM1 

EXEC 

EXCOMI 

EXEC 

EXCOM2 

EXCOMI 

EXCOM2 

EXCOMI 

EXCOMI 

EXCOMI 

EXCOMI 

EXCOM2 

EXCOM2 

EXCOMI 
EXCOMI 
EXCOMI 
EXCOMI 
EXCOM2 
EXCOMI 
EXCOMI 

EXCOM2 
EXCOMI 
EXCOMI 
EXEC 



Routines 

$ DRABO 
$ DRATX 



$ DRCIN, $DISIN 

$DRCLI, $STCLI, $STCL1 

$ DRDAR, $ DREAR 

$DRDCP, $DRECP 

$TRTRP, $DRTRP, $EMTRP, $DRDSP, $DRATP 

$DREIF, $DREXT, $DREX1 

$DREXP 

$GRGCL, $RLMCB, $RLCIB 

$DRCRE, $DRELE, $UNLCK, $GTGEF 

$DRGLI 

$DRGPP 

$DRGSS 

$DRGTK 

$DRGTP 

$DRCRW, $DRELW, $DRMAP, $DRUNM, $DRSRF, $DRRRF 

$DRGMX 

$ DRMKT, $DRRUN 

$DRREX ? $CAAST, $DRFEX, $DRPUT, $DRRRA, $DRRCV 

$DRQIO 

$DRRCS, $DRREC, $DRSND 

$DRUNS, $ DRRES, $DRSTP, $DRSPN 

$DRCEF, $DRRAF, $DRSEF, $DRSTS, $DRSTL, $DRWFL 

$DRWFS 



$DRSDV, $DRSTV 

$ELGEF, $DEAGF, $SRGEF, $DRDSE, $TKWSE, $DRWSE 

$MPXC1, $MPXC2, $DETRG, $CITFR, $DRQRQ, $SRCCQ 

$GTUCB, $STCLI, $FNCLI, $TRTRP, $EMTRP, $OTHRl 

SDRATP 
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Send /Receive Processing 

• Used to transfer a 13-word data packet to a specified task 

• Routine $DRSND in module DRRAS used to send data 

• Routine $DRREC in module DRRAS used to receive data 

• Steps in sending/receiving 

An 18-word send/receive data block is allocated in DSR 

Link word for receive queue 
Sender name in RAD50 
13-word data area 
UCB of TI : of sender 
Current UIC of sender 

A 13-word buffer in sender task is copied into DSR block 

A 15-word buffer in user task receives sender name and 
data 



DSR 



TCB < 



V 



18 WORDS 



TASK B 



■T.RCVL- 



SEND/RECEIVE 
DATA BLOCK 




15 WORD 
BUFFER 



13 WORD 
BUFFER 



^ 



> TASK B 



J 



\ 



> TASK A 



J 



Figure 11-6 Send/Receive Processing: Send from TASK A 
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r 



TCB < 



V. 



18 WORDS < 



DSR 



TASKB 



•T.RCVL 



SEND/RECEIVE 
DATA BLOCK 




15 WORD 
BUFFER 



13 WORD 
BUFFER 



A 



> TASK B 



J 



\ 



> TASK A 



J 



Figure 11-6 Send/Receive Processing: Receive by TASK B 
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Parent /Offspring Tasking 

• Connecting TASKA to TASKB 

TASKB passes a one-word status back to TASKA when 

TASKB exits 

TASKB emits status 

TASKA is the parent task, TASKB is the offspring task 

• TASKA spawns TASKB 

TASKA requests TASKB 
TASKA connects to TASKB 

• Steps in connecting 

A 14-word offspring control block is allocated in DSR 

OCB is linked to the TCB of the offspring task at T.OCBH 

When offspring exits or emits status, status moved to OCB 
placed into first word in 8-word status area 

Status automatically moved into parent status buffer 

Parent task specifies event flag and/or AST for 
notification of the offspring's return of status 
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OCB LINK WORD 




2 

4 

6 

10 

12 

14 

16 

20 

22 

24 

26 

30 

32 


O.LINK 


ADDRESS OF MCR COMMAND LINE 


O.MCRL 


PARENT TCB ADDRESS 


O.PTCB 


EXIT AST ADDRESS 


O.AST 


EXIT EVENT FLAG 


O.EFN 


EXIT STATUS BLOCK VIRTUAL ADDRESS 


O.ESB 




O.STAT 










bXII STATUS 
RIIFFER 




(8 WORDS) 

















Figure 11-7 Parent/Offspring Tasking: Offspring Control Block 
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TCBOF 
PARENT TASK 



T.RDCT=1 



TCBOF 

OFFSPRING 

TASK 



•T.OCBH- 



O.LNK=0 



O.PTCB 



TCBOF 

CONNECTING 

TASK 



T.RDCT=0 



Figure 11-7 Parent/Offspring Tasking: Spawning a Task 
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TCBOF 
PARENT TASK 



T.RDCT=1 



TCBOF 

OFFSPRING 

TASK 



■T.OCBH- 



O.LNK 



O.PTCB 



O.LNK=0 



O.PTCB 



TCBOF 

CONNECTING 

TASK 



T.RDCT=1 



Figure 11-7 Parent/Offspring Tasking: Connecting to- a Task 
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Memory Management Processing 

• User task specifies information for creating/attaching to a 
region in a Region Definition Block (RDB) 

• Information in RDB used to initialize PCB for subpartition in 
dynamic partition 

• User task specifies information for creating/mapping an 
addressing window in a Window Definition Block (WDB) 

• Information in WDB used to initialize window block in task 
header 
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REGION DEFINITION 
BLOCK 



PARTITION CONTROL 
BLOCK (PCB) 



REGION ID 



SIZE OF REGION 
I32W BLOCKS) 



NAME OF REGION 
IRADSO) 




REGION'S MAIN PARTITION NAME 

(RA050) 



REGION STATUS WORD 



REGION PROTECTION WORD 



S 

s 



LINK TO NEXT PARTITION PCB 



l/OCOUNT=0 



PRIORITY OF PARTITION 



PARTITION NAME 
|IN RADIX-SOI 



POINTER TO NEXT SUB-PARTITION 



POINTER TO MAIN 



PHYSICAL START ADDRESS OF PARTITION 



SIZE OF PARTITION 



PARTITION WAIT QUEUE LI ST HEAD 
PARTITION SWAP SIZE (SYSTEM ONLYI 



PARTITION BUSY FLAGS 



TCS ADDR. OF OWNER/CURRENT UIC OF OWNER TASK 



PARTITION STATUS FLAGS 



POINTER TO TASK HEADER 



PROTECTION WORD FOR REGION 



ATTACHMENT DESCRIPTOR 
LIST HEAD 



CREATING A REGION 



WINDOW DEFINITION 
BLOCK 



BASE APR 



WINDOW ID 



VIRTUAL BASE ADDRESS (BYTES) 



WINDOW SIZE (32W BLOCKS) 



REGION 10 



OFFSET IN REGION (32W BLOCKS) 



LENGTH TO MAP (32W BLOCKS) 



WINDOW STATUS WORD 



SEND/RECEIVE BUFFER ADDRESS (BYTES) 



TASK ADDRESSING 
WINDOW BLOCK 




PCB ADDRESS 



LOW VIRTUAL ADDRESS LIMIT 



HIGH VIRTUAL ADDRESS LIMIT 



ADDRESS OF ATTACHMENT DESCRIPTOR 



SIZE OF WINDOW IN 32. WORD BLOCKS 



PHYSICAL MEMORY OFFSET IN 32. WORD BLOCKS 



NUMBER OF 
APRS TO MAP 



FIRST PDR ADDRESS 

(LOW BYTE) 



CONTENTS OF LAST PDR 



CREATING AND MAPPING A WINDOW 

Figure 11-8 Memory Management Processing 
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ADDING A USER-WRITTEN DIRECTIVE 

• Interface to the directive processing 

Structure of Directive Parameter Block must be determined 

Entry for new directive must be added to the DDT 

Directive processing routine must be written 

Macros to invoke directive must be written 

Directive processing routine must be built into the system 

Macros must be added to the system macro library 

Structuring the Directive Parameter Block 

• Information needed to execute directive 

• Choose an unused DIC 

• Choose order for necessary parameters 

If event flag is first parameter, specify CEFNCL and/or 
CEFNMT 

If task name is first parameter, specify DFCTSK and/or 
SRSTCL 



SIZE=4 



DIC=161 



TASK NAME 



IN RAD50 



EVENT FLAG NUMBER 



Figure 11-9 Directive Parameter Block for New Directive 
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Changes to the Directive Dispatcher 

• DDT determines 

Which directive processing routine to call 

What processing to perform in DRDSP 

Size of DPB 

Where the module is to be located (directive commons) 



• Each directive is represented by a line in the DIREC macro 
defined in the module DRDSP 

• Format of line in DIREC macro is 



MAC DIC , DPBSIZ , DIRADR ,MASK , COND , SECOND 



Where 



DIC - Directive Identification Code 

DPBSIZ - Size of the DPB 

DIRADR - Address of the Directive Processing Routine 

MASK - Directive Processing Control Mask 

COND - Conditional Assembly Parameters which must 

be defined if the directive is supported 
SECOND - Conditional assembly parameters which if 

defined require that the directive have a 

variable length DPB 

Example : 

MAC 55. ,2. ,$DRCRR!PAG,<ACHKDB>,P$$LAS 

This is the "create region' directive. 

PAG is set to 1 if directive common support is 
desired, otherwise. The service routine will be 
placed in EXC0M2. 
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Place the following in the Directive Dispatch Table 
MAC 161. ,4. ,$DRFLG!PAG,<DFCTSK!SRSTCL> 

DIC 

Size of DPB 
Processing Routine 
Force to EXC0M2 
Default to current task 
Call $SRSTD to find TCB 



Example 11-2 New Entry in the Directive Dispatch Table 
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The Directive Processing Routine and Macros 

• Routine should be written to make use of the standard register 
usage in DRDSP 

• Assembly with EXEMC and RSXMC 

• Provide only macros needed by applications 



;.}. 



y 



i 



.TITLE DRFLG 
..TDENT 71.0/ 

** - *DRFLG - SET TASK'S LOCAL EVENT FLAG 

THIS DIRECTIVE INSTRUCTS THE SYSTEM TO SET A SPECIFIED TASK'S LOCAL 
EVENT FLAG. 

DPB FORMAT J 

i WD. 00 — DIC (161. )r DPB SIZE (4.) 

■• WD. 01 — FIRST HALF OF TASK NAME (RAD50) 

y WD. 02 ■■— SECOND HALF OF TASK NAME (RAD50) 

I WD. 03 — EVENT FLAG NUMBER (1-32.) 

5 

5 inputs; 

i ro = tcb addr. of target task 

v rl = addr. of first task status word 

j r2 = addr. of second task status word 

y r3 = addr. of next word in dpb 

p r4 = addr. of header of current task 

? r5 ■:= addr. of tcb of current task 

i outputs: 

5 C = IF DIRECTIVE IS SUCCESSFULLY COMPLETED 

? DIRECTIVE STATUS D.RS22 IS RETURNED IF EVENT FLAG IS 

? ALREADY SET 

? DIRECTIVE STATUS D.RSOO IS RETURNED IF EVENT FLAG WAS 

? CLEARED 

? C = 1 IF DIRECTIVE IS REJECTED 

P DIRECTIVE STATUS D.RS97 IS RETURNED IF ILLEGAL EVENT 

? FLAG 

j> •-■ 

.ENABL LSB 

*drflg: i 

MOV R0»R5 t ADDR OF TARGET TASK TCB 

CALL *CEFN > CONVERT TO EVENT FLAG MASK 

DCS 20* S ILLEGAL EVENT FLAG 

BIT R0»(R1) f EVENT FLAG ALREADY SET? 

BEQ 10* P NO r IF EQUAL. 

DRSTS D.RS22 r RETURN STATUS 

.1.0* J BIS ROf(Rl) PSET THE EVENT FLAG 

DRSTS D.RSOO J RETURN STATUS 

20*3 DRSTS D.RS97 P ILLEGAL EVENT FLAG STATUS 

.END 

Example 11-3 Processing Routine for New Directive 
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% % FORM OF MACRO FOR *DRFLG 

t. 

♦MACRO SLEF* TNrEFN 

♦ BYTE 161 ♦? 4 
R50* TN 
♦WORD EFN 

♦ ENDM SLEF* 
P + 

9 *C FORM OF MACRO FOR fDRFLG 



y -- 



*** 



♦MACRO SLEF*C TNyEFN.»ERR*PST 
♦PSECT *DPB** 



♦BYTE 161* rA 

R50* TN 

♦WORD EFN 

. PSECT PST 

MOU #***»- (SP> 

EMT "0<377> 

♦IF NB ERR 

BCC .+6 

JSR PC 9 ERR 

♦ ENBC 

♦ENBM SLEF*C 
*•¥ 

9 *S FORM OF MACRO FOR *DRFLG 

? ~ 

♦MACRO SLEF*S TN»EFN*ERR 

MOM$ EFN 

RFA$ TN 

MOV <PC)+»-(SP) 

♦BYTE 161. > 4 

DIR* »ERR 

♦ENDM SLEF*S 



Example 11-4 Macros for New Directive 
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Adding a Directive to the System 

• Directive can be included in the Executive or in EXC0M2 

In the Executive if 

Directive commons not chosen at SYSGEN 
Not enough room in EXC0M2 

Otherwise in EXC0M2 

• To include in the Executive 

Build with the Executive during SYSGEN 

• To include in EXC0M2 

Build with EXC0M2 during SYSGEN 

• Macros included in system macro library RSXMAC.SML 
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MAC DRFLG=LB:[1,1]EXEMC/ML,SY:[11,10]RSXMC,DRFLG 
4 LBRLB:[1,24]RSX11M/IN :DRFLG 

4 LB:[1,24]RSX11M/LB:DRFLG 

1 TKB @RSXBLD 



ASSEMBLE 

DIRECTIVE 

ROUTINE 



ADD OBJECT 

MODULE TO 

LIBRARY 



ADD LINE 
TO TASK BUILD 
COMMAND FILE 



4 



TASK BUILD 



Figure 11-10 Assembling and Taskbuilding the Processing Routine 
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I/O PROCESSING 



INTRODUCTION 

Any modern operating system must provide a complete I/O 
system. Besides providing basic I/O device handling software, it 
must also provide a convenient file system. 

Device drivers handle primitive I/O functions under RSX-11M. 
These drivers are tailored to individual devices and optimized to 
provide maximum performance. They are invoked by means of the QIO 
mechanism. 

RSX-11M uses the FILES-11 file system. There are two levels 
of software support in the operating system for FILES-11. The 
more visible level includes the file access systems, FCS, and RMS. 
These systems provide all features needed in any application under 
RSX-11M. A more primitive level, in the form of ACPs (F11ACP) , 
forms the interface between FCS/RMS and device drivers. 



OBJECTIVES 

1. Diagram the flow in the I/O system. 

2. List the types of ACPs and their differences. 

3. List the steps in processing an I/O request within DRQIO. 

RESOURCES 

1. RSX-11M System Lists and Data Structures 

2. RSX-11M Guide to Writing an I/O Driver 

3. RSX-11M/M-PLUS I/O Operations References Manual 
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OVERVIEW 

Components of the I/O System 

• The File System 

Used to structure data for convenient use in applications 
Provides software for easy manipulation of data 
Consists of: 

FILES-11 structures 

File Control Services (FCS) 

Record Management Services (RMS) 

• QIO directive 

Used to request I/O service from the Executive 

Can be used directly in user task 

All file-system I/O requests converted into QIOs 

• Device Drivers 

Used to control physical devices and perform actual I/O 
One required for each device type 
Carry I/O requests to transfer data 
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• Ancillary Control Processor (ACP) 

Performs functions subordinate to those of the driver 
Provides a file system for user tasks 
Handles protocols needed by a communications network 



Converts I/O requests into one or more request to a device 
driver 

Manipulates I/O parts of the system data base 

Three ACPs provided with RSX-11M 



F11ACP 
MTAACP 
NETACP 



Files-11 
Magtape I/O ACP 
DECNET ACP 
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USER STATE j SYSTEM STATE 

I 



USER TASK 
QIO — 



© 



UQIO 



NOTE: UQIO: USER ISSUED QIO 
AQIO: ACP ISSUED QIO 



DRQIO 




CALL $GTPKT 



© 



© 



Figure 12-1 The I/O Process 
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Initiating I/O From a User Task 

• Use QIO directives 

Harder to use than other methods 
Can be the most efficient method of I/O 
For file I/O, use virtual block transfers 
For non-file I/O, use logical block transfers 

• Use high-level language I/O commands 

Easier to use than QIOs, but less efficient 

Language processor may convert to QIOs or convert to 
FCS/RMS commands 



Use FCS/RMS to perform file system I/O 

Allows data to be accessed in a form natural to the 
application 



File processor converts to QIOs 



330 



I/O PROCESSING 

ocessing I/O Request in DRQIO 

All I/O performed as a result of QIO directives 

QIO directive parameters are checked; directive status is 
returned 

Parameters used to create I/O packet 

I/O packet is queued to a device driver or to an ACP 

If ACP function, a number of checks are performed before 
queuing I/O packet 
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QIO PROCESSING 



Logical Units 

• Logical Unit Numbers (LUNs) identify the device to which I/O 
is to be performed 

• LUN determines a unique entry in the task's Logical Unit Table 
(LUT) in the task header 

• Each entry in the LUT is two words long 

• When a task is installed, the first word of each LUT entry is 
initialized with the UCB address of the device 

• When a file is opened on a volume, the second word of the 
corresponding LUN points to a FILES-11 window block 



USER TASK 



QIO -,3,... 



LUT 



TASK 
HEADER 



UCB ADDR. 




Figure 12-2 Logical Units 
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Processing Within DRQIO 

• Locates the UCB for LUN 

Calls $MPLUN in module EXESB 

• Checks to see if driver resident 

Location D.DSP in the DCB 

• Clears specified event flag 

• Clears I/O status block if specified 

• QIO directive is now successful 

DSW shows success 

Any errors are reported as I/O errors in the IOSB 

• Allocates space for I/O packet in POOL 

Calls $ALPKT in module CORAL 

Increments I/O request count in the TCB 

Copy data from DPB to I/O packet 

If function is IO.KIL, go the routine $IOKIL in module IOSUB 

Check if task has privileges to perform I/O 

Check function code against function masks in DCB 

If not legal function, return I/O error 

If control function, queue I/O packet to driver 

If 'no-op' function, return successful status 

If ACP function to mounted device, perform ACP function checks 
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The ACP Function Checks 

• Implemented by a collection of primitive routines 

• Each ACP requires a different group of these routines 

• A two-level dispatch table, the Polish Interpreter Database, 
is used 

• First level table, the Function Code Dispatch Vector, resides 
at FCDSP in DRQIO 

Each entry corresponds to a unique function code 

Each entry is a vector which points to a second level 
dispatch table 

• Second level dispatch table contains primitive routines to be 
called 
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Table 12-1 


Function 


Dispatch 


Code 


Table 


10 


FCIFC 


11 


FCPKT 


12 


UNLCK 


13 


FCPKT 


14 


FCPKT 


15 


FCACC 


16 


FCACC 


17 


FCACC 


20 


FCDAC 


21 


FCRVB 


22 


FCWVB 


23 


FCEXT 


24 


FCCRE 


25 


FCDEL 


26 


FCPKT 


27 


FCPKT 


30 


FCPKT 


31 


FCWVB 


32 


FCRVB 


33 


FCCON 


34 


FCDIS 


35 


FCNCT 


36 


FCIFC 


37 


FCIFC 



Function Code Dispatch Vector 

Function 

Illegal function 

Find file name in directory 

Unlock Block 

Remove file name from directory 

Enter file name in directory 

Access file for READ 

Access file for READ and WRITE 

Access file for READ, WRITE, and EXTEND 

Deaccess file 

Read Virtual Block 

Write Virtual Block 

Extend file 

Create file 

Mark file for DELETE/TRUNCATE file 

Read file attributes 

Write file attributes 

User magtape control function 

Transmit process message 

Receive process message 

Connect to process 

Disconnect from process 

Network control process 

Illegal function 

Illegal function 
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Table 


Routii 


FCIFC 


IEIFC 


FCACC 


CKDMO 




CKALN 




CKMOU 




CKACP 




BDPKT 




CKRLK 


FCDAC 


CKNLN 




CKQMT 




BDPKT 




CKRLK 


FCRVB 


CKNLN 




CKRAC 


FCWVB 


CKNLN 




CKWAC 


FCCRE 


CKDMO 




CKALN 




CKPKT 


FCDEL 


CKTRN 




CKACP 




CKMOU 




BDPKT 




CKXIT 


FCPKT 


CKACP 




CKMOU 




BDPKT 




CKXIT 


FCEXT 


CKPND 


UNLCK 


CKNLN 




UNLXT 


FCC ON 


CKDMO 




CKALN 




CKCON 




CKRLK 



Table 12-2 Polish Routines 

Function 

Set illegal function status 

Check if volume marked for dismount 
Check if file already accessed on LUN 
Check volume mounted this user 
Set flag to queue to ACP 
Build an I/O packet 
Synchronize access and exit 

Check if file accessed on LUN 
Queue to MTAACP if ANSI 
Build an I/O packet 
Synchronize and exit 

Check if file accessed on LUN 
Check read access and exit 

Check if file accessed on LUN 
Check write access and exit 

Check if volume marked for dismount 
Check if file accessed on LUN 
Join common ACP and check mount 



Check if really truncate 
Set flag to queue to ACP 
Check volume mounted by this 
Build an I/O packet 
Exit 



user 



Set flag to queue to ACP 
Check volume mounted by this 
Build an I/O packet 
Exit 



user 



Increment window pending count for extend 

Check if file accessed on LUN 
Set registers and exit 

Check if volume marked for dismount 
Check if process already connected on LUN 
Address check connect buffer 
Interlock LUN usage and exit 



336 



I/O PROCESSING 



Table 
FCDIS 

FCNCT 



Table 12-2 Polish Routines (Cont) 
Routine Function 



CKNLN 
CKDIS 

CKRLK 

CKDMO 

CKCON 
CKXIT 



Check if process connected on LUN 
Check buffer and copy parameters 
Interlock LUN usage and exit 

Check if volume marked for dismount 

Address check buffer 

Exit 



337 



I/O PROCESSING 



Queuing I/O Requests 

• I/O request packets are queued by routine $DRQRQ in module 
DRSUB 

• Processing in $DRQRQ 

Bit UC.QUE in U.CTL in the UCB is checked 

If set, packet queued to driver 

Contents of KERNEL APR 5 is saved on stack 

If driver loadable, base address of driver loaded into 
KERNEL APR 5 

The driver is called to initiate I/O 

When driver exits 

Control returns to $DRQRQ 

Original contents of KERNEL APR 5 are restored 



338 



I/O PROCESSING 

ANCILLARY CONTROL PROCESSORS 

Types of ACPs 

• Standard ACPs 

Known to the Executive 

Executive includes special code for support 

Follow rules used by DEC in writing F11ACP and MTAACP 

• User ACPs 

Not known to the Executive 

Known only to the driver which uses their services 

UC.QUE set in U.CTL to prevent ACP function checks in 
DRQIO 

Driver does preprocessing and queues requests to ACPs 

No change to the Executive code is necessary 

• Foreign ACPs 

Between standard and user ACPs 

Known to the Executive 

No special services provided to support ACP 

Identified by foreign bit US. FOR in the UCB 
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t QIO 



CHECK FOR LEGALITY 

CONSTRUCT I/O PACKET 

SPECIAL ACP PROCESSING 

QUEUE TO ACP IF SPECIFIED 



t JMP 



QUEUE I/O PACKET 
CALL DRIVER INITIATOR 



¥ JSR 



CALL $GTPKT 



T JSR 



GET I/O PACKET 
DETERMINE ACP FUNCTION 



» ? JSR 



QUEUE PACKET TO ACP 
REQUEST ACP 



SDRQIO 



$DRQRQ 



DEVICE DRIVER 



$GTPKT 



SEXRQP 



Figure 12-3 Standard ACP 
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t QIO 



CHECK FOR LEGALITY 

CONSTRUCT I/O PACKET 

COPY I/O PARAMETERS 



f JMP 



CALL DRIVER INITIATOR 



t JSR 



SPECIAL ACP PROCESSING 
QUEUE TO ACP 



t JSR 



QUEUE I/O PACKET TO ACP 
REQUEST ACP 



$DRQIO 



$DRQRQ 



DEVICE DRIVER 



$EXRQP 



Figure 12-4 User ACP 
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CHECK FOR LEGALITY 

CONSTRUCT I/O PACKET 

COPY I/O PARAMETERS 

QUEUE TO ACP IF UC.QUE=0 



JMP 



CALL DRIVER INITIATOR 
t JSR ~ 



SPECIAL ACP PROCESSING 

QUEUE I/O PACKET 

CALL $GTPKT 



T JSR 



GET I/O PACKET 
DETERMINE ACP FUNCTION 



» t JSR 



QUEUE PACKET TO ACP 
REQUEST ACP 



SDRQIO 



$DRQRQ 



DEVICE DRIVER 



$GTPKT 



$EXRQP 



Figure 12-5 Foreign ACP 



342 



I/O PROCESSING 



TheFILES-11 (F11ACP) 

• Implements the FILES-11 structure for disks 

• Provides needed file primitives (open, close, etc.) 

• Converts file primitives to driver primitives 

Open file requires several driver operations: 

Locating the file which may require several reads of 
directory records and headers 

Creating the FCB from the file header 

Creating the window block from the retrieval pointers 

Versions available at SYSGEN 

• MINIMUM Version 

Not recomended for general use 
Runs in 2K words of memory 
Heavily overlaid 

No internal buffers for storing data 
Mapped and unmapped systems 

• SMALL Version 

Provides limited performance optimization 

Requires 10 to 100 times more I/O for directory lookups 
and file opens than larger ACPs 

Heavily overlaid 

Runs in 2.5K words of memory 

Mapped and unmapped systems 

Default version for unmapped systems 
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MIDDLE Version 

Usually provides the best performance without using large 
amount of memory 

Provides buffers for storing directories and the index 
file bitmap 

Runs in 5K words of memory 

Mapped and unmapped systems 

Default version for mapped systems 

LARGE Version 

Provides the maximum performance for F11ACP 

Not overlaid 

Runs in 10K words of memory 

Provides larger buffers for storing directories 

Available only on mapped systems 
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DEVICE DRIVER PROCESSING 



INTRODUCTION 

Most tasks receive raw data from external sources and provide 
results to the user. It is usually necessary to keep large 
amounts of data available to the processor for instant use. To 
provide these services, an I/O system is needed. The basic 
component of this system is the software which handles the 
activities of the physical devices. Under RSX-11M, this software 
is called a device driver. 

RSX-11M provides drivers for each supported peripheral 
device. The interface between a driver and the I/O system is 
simple and standard. The user can write drivers for non-standard 
devices by adhering to the requirements of this interface. 



OBJECTIVES 

1. Diagram the flow of control during device driver processing. 

2. Determine the status of a device by examining its data 
structures. 

3. Diagram the process of performing I/O with a DMA UNIBUS device 
on the PDP-11/44 or 70. 



RESOURCES 



1. RSX-11M System Lists and Data Structures 

2. RSX-11M Guide to Writing a Device Driver 
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OVERVIEW 

Methods of Performing I/O 

• Device common 

Partition in I/O Page 

Built and used as any other common area 

Can only perform 'device-poll' device driving 

• Direct access to I/O page 

Privileged task has access to I/O page 

Can only perform 'device-poll' device driving 

• CINT$ Directive 

Task contains essential routines to drive device 
Very little knowledge of system interface required 
Easy to debug 
Interrupt driven 

• Device Driver 

Integral part of the Executive 

Is written to use QIO mechanism 

Usually interrupt driven but can do 'device-poll' 
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Design Philosophy 



• 



One device driver per device type 
Handles multiple controllers 

Common I/O processing done in Executive routines 
Queuing of I/O request in module DRQIO 
I/O completion handled by routine $IODON in module IOSUB 

Keep interrupt lockout to a minimum 

Run at priority 7, no more than 100 microseconds 

Run at priority of interrupting device, no more than 500 
microseconds 



• Use a FORK process to access the system data base 



• 



350 



DEVICE DRIVER PROCESSING 

General Flow 

• User task issues QIO directive 

Executive entered as result of EMT instruction 

• Executive processes QIO 

Checks made on data in DPB 

Mapping adjusted to map to service routine and DPB 

• Module DRQIO processes QIO 

Checks made on I/O request 

I/O packet created and queued to driver 

• Driver called at initiate I/O entry point 

I/O packet retrieved 
Data in packet processed 
I/O device started 



• Control returns to user task if asynchronous I/O, Executive 
otherwise 

• When interrupt occurs, driver entered at interrupt entry point 
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DRIVER DATA BASE 

• Location 

In module SYSTB for DEC-supplied drivers 

If user-written driver with 

Resident data base, in Executive 
Loadable data base, in DSR 

Device Control Block (DCB) 

• One per device type 

• Describes static characteristics of device 

• Linked to device list 

Headed by $DEVHD in Executive module SYSCM 
List linked by D. LNK in DCB 

• Contains 

D.DSP - Address of Driver Dispatch Table 

D.MSK - Function masks for filtering QIO requests 

D.UCB - Link to first UCB 

D.UCBL - Length of UCB for device type 

D.NAM - Generic device name in ASCII 

D.UNIT - Highest and lowest unit number 

• Used by QIO processing, not by driver 
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Unit Control Block (UCB) 

• One per physical unit 

• Contains mostly static data 

• Most other data structures can be accessed from UCB 

• UCB for unit linked from D.UCB in the DCB for device type 

• Other UCBs for device type contiguous with UCB for unit 

• Contains 

U.DCB - Pointer back to DCB for device type 
U.RED - Pointer to UCB of redirect device 
U.UNIT - Physical unit number 
U.SCB - Pointer to SCB of controller for this unit 

• Used by both driver and Executive 
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Entry 


Of 


U.DCB 





U.SCB 


20 


U.UNIT 


6 


U.RED 


2 


U.STS 


5 


U.ST2 


7 


U.CTL 


4 


U.CW1 


10 


U.CW2 


12 


U.CW3 


14 


U.CW4 


16 


U.CLI 


-6 


U.LUIC 


-4 


U . OWN 


-2 


Notes: 


1. 



DEVICE DRIVER PROCESSING 

Table 13-1 Important Entries in the UCB 

:set Length Contents 

WORD Address of DCB for device type 

WORD Address of SCB for unit 

BYTE Physical unit number 

WORD Address of UCB for redirect 

BYTE Unit status bits 

BYTE More unit status bits 

BYTE Unit control flags 

WORD 1st device characteristics word 

WORD 2nd device characteristics word 

WORD 3rd device characteristics word 

WORD 4th device characteristics word 

WORD Default CLI 

WORD Login UIC 

WORD Owning terminal 

U.CLI and U.LUIC exist only for terminals 
1. U.LUIC exists if system is multi-user 
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.DC0 



.LP0 



U.STS 
U.ST2 



DV.REC ! DV. CCL 



140100 



132. 



$LP0 






U.DCB 


2 


U.RED 


4 


U.CTL 


6 


U.UNIT 


10 


U.CW1 


12 


U.CW2 


14 


U.CW3 


16 


U.CW4 


20 


U.SCB 


22 


U.ATT 


24 


U.BUF 


26 




30 


U.CNT 



Figure 13-1 Unit Control Block for LP: 
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U.ERHL 
U.ERHC 



U.STS 
U.ST2 






8. 


5 











.DCO 


.DKO 


UC.ALG!UC.NPR!UC.PWF 


US.MNT 








DV.DIR!DV.MNT!DV.F11!DV.MSD!DV.UMD 





4800. 


512. 


$DKO 





















-10 U.IOC 

-6 U.ERSL 

-4 U.ERSC 

-2 U.OWN 

U.DCB 

2 U.RED 

4 U.CTL 

6 U.UNIT 

10 U.CW1 

12 U.CW2 

14 U.CW3 

16 U.CW4 

20 U.SCB 

22 U.ATT 

24 U.BUF 
26 

30 U.CNT 

32 U.ACP 

34 U.VCB 



Figure 13-2 Unit Control Block for DK 
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Status Control Block (SCB) 

One SCB per controller 

Line multiplexers (DH-11, DJ-11, etc.) have one controller per 
line 

Most information is dynamic 

Linked from U.SCB in the UCB 

One SCB is linked from several UCBs if controller is common to 
several units 

Contains 

S.LHD - Device I/O queue listhead 

S.PKT - Address of current I/O packet 

S.PRI - Device priority 

S.CTM - Current time out count 

S.ITM - Initial time out count 

S.CSR - Address of Control Status Register 

S.FRK - The FORK block 

Used by driver and Executive 
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S.ROFF-7 



S.VCT 5 
S.ITM 7 
S.STS 11 



UMR i 

ASSIGNMENT 
BLOCK 

M.UFVF 



REGS. TO COPY ON ERROR 


OFFSET TO 1ST REG. 


-6 
-4 
-2 



2 

4 

6 

10 

12 

14 

16 

20 


S.RCNT 


SAVED I/O ACTIVE BIT MAP 


S.BMSV 


DEVICE I/O ACTIVE BIT MASK 


S.BMSK 


CONTROLLER I/O 


S.LHD 


QUEUE LISTHEAD 




VECTOR ADDR/4 


PRIORITY 


S.PRI 


INITIAL TIMEOUT COUNT 


CURRENT TIMEOUT COUNT 


S.CTM 


CONTROLLER STATUS 


CONTROLLER INDEX 


S.CON 


ADDRESS OF CSR 


S.CSR 


ADDRESS OF CURRENT I/O PACKET 


S.PKT 


FORK BLOCK LINK WORD 


S.FRK 


FORK - PC 




FORK - R5 


22 

24 
26 
30 
32 
34 
36 
40 
42 




FORK - R4 




FORK-DRIVER RELOCATION BASE 




LINK WORD 


S.MPR/M.I 


ADDRESS OF FIRST ASSIGNED UMR 


M.UMRA 


NUMBER OF UMR'S ASSIGNED "4 


M.UMRN 


LOW 16 BITS MAPPED BY 1ST UMR 


M.UMVL 


HIGH 6 BITS OF BUFFER 


HIGH 2 BITS MAPPED 


M.UMVH 


LOW 16 BITS OF PHYSICAL BUFFER ADDRESS 


M.VFVL 



Figure 13-3 Status Control Block 
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I/O Packet 

• Used to communicate between Executive and device driver 

• Created by Executive in DSR 

• One for each I/O request queued to driver 

• Each SCB has an I/O queue consisting of pending I/O packets 

Linked from listhead S.LHD in the SCB 
Linked in order of decreasing task priority 
Packet is removed from queue when service begins 

• Current I/O packet is linked from S.PKT in the SCB 

• Contains 

I.PRI - Priority of request 

I.EFN - Event flag to use for synchronization 

I.TCB - Address of TCB of requesting task 

I.FCN - I/O function code 

I.IOSB - I/O status block address 

LAST - Address of AST service routine 

I.PRM - I/O parameter list 
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I/O QUEUE LINK WORD 



I.EFN 3 



EVENT FLAG NUMBER 



REQUEST PRIORITY 



TCB ADDRESS OF REQUESTER 



POINTER TO SECOND LUT WORD 



POINTER TO UNIT CONTROL BLOCK 



MAIN FUNCTION CODE 



MODIFIER 



VIRTUAL ADDRESS OF I/O STATUS BLOCK 

RELOCATION BIAS (32 10 WORD BLOCK ADDRESS) 

KERNEL VIRTUAL ADDRESS (140000 + DIB) 

VIRTUAL ADDRESS OF AST ROUTINE 

RESERVED FOR MAPPING PARAMETER1 

PARAMETERS 



1-6 




2 
4 
6 
10 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 
36 
40 



I.LNK 

I.PRI 

I.TCB 

I.LN2 

I.UCB 

I.FCN 

I.IOSB 



LAST 
I.PRM 



Figure 13-4 I/O Packet 
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^ 


UNIBUS £- 


















CPU 




DISK 
CONTROLLER 




CONTROLLER 
DL-11 




CONTROLLER 
FOR LP 


































RP06 






LA36 




LP- 11 







I ^ 


OCB 
FOR 
TT: 




UCB 
FOR 
TT0: 




SCB 








>— ► 








DCB 
FOR 
LP: 


UCB 
FOR 
LP0: 


SCB 







Figure 13-5 A Simple Configuration 
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^ 


UNIBUS ^ 


















CPU 




DISK 
CONTROLLER 




CONTROLLER 
DL-11 




CONTROLLER 
FOR LP 






































RP#6 




RP06 




LA36 




LP- 11 






DCB 
FOR 
LP: 




UCB 
FOR 
LP0: 




SCB 







Figure 13-6 A Configuration with Multiple Units 
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.> UNIBUS £• 












1 












CPU 




DISK 
CONTROLLER 




DISK 
CONTROLLER 




CONTROLLER 
DL-11 




CONTROLLER 
FOR LP 


















































RPJ06 




RP06 




RP06 




RP06 




LA36 




LP- 11 






DCB 
FOR 
LP: 




UCB 
FOR 
LP0: 




SCB 







UCB 
FOR 
DB0: 






SCB 










UCB 
FOR 
DB1: 










UCB 
FOR 
DB2: 




► 


SCB 






UCB 
FOR 
DB3: 











Figure 13-7 A Configuration with Multiple Controllers 
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DRIVER STRUCTURE 

Driver Entry Points 

• Initiate I/O Entry Point 

Used to initiate an I/O operation 
Called from routine $DRQIO 
Executes at processor priority 
Name of entry point: XXINI 

• Kill I/O Entry Point 

Cancels in-progress requests for non block-addressable 
devices 

Called from routines $DRQIO and $DREIF 

Executes at device priority 

Name of entry point: XXCAN 

• Time-out Entry Point 

Used when driver does not interrupt within specified time 
interval after a request 

Called from module TDSCH 

Executes at device priority 

Action: Retry I/O operation 

After eight retries, I/O operation is aborted 

Name of entry point: XXTMO 

• Powerfail Entry Point 

Called by module INITL and by SAVE to initialize device 

Reinitializes device after powerfail 

Called from routine POWER after power is restored 

Executes at processor priority 

Name of entry point: XXPWF 
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Interrupt Entry Point 

Services interrupts from device 
Address stored in interrupt vector 
Entered at processor priority 7 
Entry Point Names Critical 

XXINT - Single interrupt driver 
XXINP - Input, two interrupt drivers 
XXOUT - Output, two interrupt drivers 



Driver Dispatch Table 

• Table containing addresses of service routines for all entry 
points except the interrupt entry 

• Table is in the device driver at location $XXTBL 

$XXTBL:: 

.WORD XXINI ;Initiate I/O 

.WORD XXCAN /Cancel I/O 

.WORD XXTMO ; Device Timeout 

.WORD XXPWF ; Power fail 

• Pointed to by D.DSP in the DCB 

• Entries are local symbols whose order is critical 
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USER 
TASK 

OIO 




EMT 
TRAP VECTOR 


30 
32 











CLOCK INTERRUPT 
VECTOR 



100 




102 





POWERFAIL 
TRAP VECTOR 



24 

26 



INITL 

OR 

SAVE 

OR 
LOAD 



0RSU8 

$emtrp: : 



T 



DRDSP 



DIRECTIVE 
DISPATCH TABLE 



T 




TDSCH 



POWER 



DEVICE DRIVER 



DRIVER 
DISPATCH TABLE 



INITIATE 

I/O 




Figure 13-8 Driver Flow 
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♦TITLE XXDRk 



fcXXTBLt 


* 






. WORD 


XXI N I 




♦ WORD 


XXCAN 




♦ WORD 


XXTMO 




♦ WORD 


XXPWF 


XXINIJ 


CALL 


♦GTPKT 




BCC 


.+4 




RETURN 






MOV 


#IS*SUC4377»R0 




CLR 


Rl 




CALL 


*IODON 


XXCAN 1 






XXTMOS 






XXPWF t 






xxint:: 


RETURN 
*END 





Example 13-1 A Skeleton Driver 
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TITLE XXTAB 





♦MCALL 


DCBDF* »UCBDF$ 






DCBDF* 








UCBDF* 






SXXDAT: 


* + 
> * 






xxdcbj 


♦ WORD 









♦ WORD 


♦ XXO 






♦ASCII 


/XX/ 






.BYTE 


0?0 






♦ WORD 


XXND-XXST 






♦ WORD 









♦ WORD 


177777 






. WORD 


30 






♦ WORD 









♦ WORD 


177740 






♦ WORD 


377 






<■ WORD 









♦ WORD 









♦ WORD 


377 






. WORD 







XXST= < 








♦ xxo: i 


♦ WORD 


XXDCB 






♦ WORD 


.-2 






♦ BYTE 


0»US.MNT»Os>0 






♦ WORD 


DV.MNTIDV.F11 






. WORD 


0>0 






♦ WORD 


80. 






. WORD 


$XXO 






♦ WORD 


Oi-OxOkO 






♦ WORD 





rU.ACP 




♦ WORD 





i U ♦ VCB 


XXND= . 








*xxo: t 


♦ WORD 









♦ WORD 


.-2 






♦ WORD 


9 r ? v ? y r 1 


> r 


*XXENDJ 


♦ 







♦ END 



Example 13-2 A Skeleton Driver Data Base 
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DRIVER PROCESSING 
Initiate I/O 

• Call $GTPKT to get an I/O packet 

Carry set on return from $GTPKT 
No packet 
ACP function 
Controller busy 

• Registers on return from $GTPKT 

Rl - Address of I/O packet 

R2 - Physical unit number 

R3 - Controller index (into CNTBL) 

R4 - Address of SCB 

R5 - Address of UCB 

• UCB address saved in CNTBL 

• Perform initiation of I/O including 

Allocating UMRs if a DMA device on 11/44 or 11/70 

Setting up device timeout 

If error logging, call $BMSET 

Checking function code 

Performing operations on CSR(s) 

Mapping UMR(s) if required 

Enabling interrupts 
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Kill I/O 

• Registers when entry point called 

R5 - Address of UCB 

R4 - Address of SCB 

R3 - Controller index 

Rl - TCB of current task 

R0 - Active I/O packet 

• Processor is at device priority when called 

• Cancel current I/O operation by 

Zeroing byte-count or flagging abort 
Canceling timeout by zeroing S.CTM in the SCB 

• For DMA devices, current operation may not be canceled 
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Device Timeout 

• Registers when entry point called 
R5 - Address of UCB 
R4 - Address of SCB 
R3 - Controller index 
R2 - Address of CSR 
R0 - I/O status code (IE.DNR) 

Processor at device priority when called 

Generate error message by calling $DVMSG with T.NDNR in R0 

If error logging, call $DTOER 

Reset timeout count if required 

Retry I/O operation required number of times 
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Powerfail 

• Registers when entry point is called 

R5 - Address of UCB 
R4 - Address of SCB 
R3 - Controller index 

• Processor at processor priority when called 

• Uses timeout mechanism for device recovery 

Special timeout count is used for many devices 

Performs other initialization tasks (e.g., the KMC-11 for 
the lineprinter) 

Interrupt Processing 

• Registers R4 and R5 saved on entry, others cannot be used 
except in FORK process code 

• Processor priority 

At call: 7 

After return from $INTSV: Device priority 

During FORK processing: 
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DEVICE DRIVER 



ENABLE INTERRUPT- 



INTERRUPT ENTRY 

GET CHARACTER «4h 




PUT INTO USER BUFFER 
END OF LINE? 

IF NOT REPEAT 

IF YES 

COMPLETE I/O 



USER DATA-*^- 
BUFFER 



CONTROLLER 



CSR 



4DATA BUFFER REG 




Figure 13-9 Interrupt Processing - Non DMA Device 
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DEVICE DRIVER 



LOAD BUS ADDRESS' 
LOAD WORD COUNT> 



LOAD SECTOR. TRACK. ETC 
ENABLE INTERRUPT 




INTERRUPT ENTRY <4f 



USER DATA 
BUFFER 



CONTROLLER 



|» | UNIBUS ADDRESS REG. | 
EH WORD COUNT REG. j 



' I CONTROL STATUS REG~| 



START TRANSFER, 
•ISSUE INTERRUPT 




Figure 13-10 Interrupt Processing - DMA Device 
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ADVANCED DRIVER FEATURES 
Loadable Drivers 

• Not physically within the Executive, but in a user partition 

• Frees part of KERNEL address space to be used to map added DSR 

• LOAD command brings into memory 

• UNLOAD command removes from memory 

• Consists of three parts 

Interrupt Control Block in DSR 

Driver code loaded into driver partition 

Driver Data Base loaded in DSR 

The Interrupt Control Block 

• Created by LOAD command in DSR 

• Contains 

Location to which control is transfered by interrupt 
Call to interrupt save routine, to save registers 
Code to map driver code usinq KERNEL apr ^ 



375 



DEVICE DRIVER PROCESSING 



TXDRV 
-#► SXXINT: 



RETURN- 



© 



© 



osn 



ICB 



© 



© 



EXECUTIVE 



-►SINTSV- 



© 



SINTXT:: ♦ 



RT> — 
VECTOR 



© 



© 



RESUME USER 
TASK 



Figure 13-11 A Loadable Driver 
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113767 



177776 



MFPS TEMP 



50 



004537 



ADDR OF $INTSV 



JSR R5, @#$INTSV 



177753(TYPICAL) .WORD t C <PR1> 



016704 



000036 



MOV TEMP.R4 1 



043704 



177760 



BICtC<17>,R4 1 



006304 



ASL 



R4' 



013746 



172352 



MOV @#KISAR5, -(SP) 



012737 



DRIVER RELOCATION BIAS MOV # RELBAS,@#KISAR5 



172352 



004737 



JSR PC,@#INTSRV 



ADDRESS OF INTERRUPT SERVICE ROUTINE 



012637 



172352 



MOV (SP)+,e#KISAR5 



000207 



RETURN 



000000 



TEMP:.BLKW 



1 1 



1. MULTI-CONTROLLER DRIVERS 



Figure 13-12 The Interrupt Control Block 
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Resident and Loadable Data Base 

• Data base for loadable driver can be loadable or resident 

• Resident data base created when system is built and included 
in the Executive 

• Loadable data base can be created at any time 

Loaded in DSR by LOAD command if not already in memory 
Not unloaded by UNLOAD command 



UNIBUS Mapping Registers 

Problem: 

• Direct Memory Access (DMA) devices 

Transfer data directly between the device and physical 
memory 

Require physical address to be passed to UNIBUS 

• In some PDP-lls, physical addresses require 22 bits 

• UNIBUS accepts only 18-bit addresses 

Solution: 

• 31 UNIBUS Mapping Registers (UMRs) are provided 

• Each UMR maps 4K words of physical memory 

• 124K words of address space just below the I/O page are 
relocated using UMRs 
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740000 




•^ 563200 

^^- 543200 




UNIBUS MAPPING REGISTERS 



007444 



007244 



004070 



003670 



003470 



PHYSICAL 
MEMORY 



724400 



347000 



Figure 13-13 UNIBUS Mapping Registers 
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TRANSFER A BLOCK OF 8K WORDS 
USER BUFFER ADDRESS ~ 1344200 
UMR'S 3 AND 4 ARE TO BE USED 
UMR STRUCTURE} 

BITS 13-17 = NUMBER OF UMR 

BITS -12 -"-- OFFSET TO BASE ADDRESS IN UMR 
THEREFORE J 

UMR 3 = 13442 

UMR 4 = 13642 
THE ADDRESS SUPPLIED TO THE UNIBUS IS 060000 

Example 13-3 UMR Address Relocation 
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SCB 



SCB 



SCB 




MAPPING 

ASSIGNMENT 

BLOCK 



V. 



MAPPING 

ASSIGNMENT 

BLOCK 



MAPPING 

ASSIGNMENT 

BLOCK 



"V 



y 



IN ORDER OF UMR NUMBER 



Figure 13-14 Mapping Assignment Block List 



SCB 



SCB 



SCB 




MAPPING 

ASSIGNMENT 

BLOCK 



V. 



MAPPING 

ASSIGNMENT 

BLOCK 



MAPPING 

ASSIGNMENT 

BLOCK 



"V 



FIFO QUEUE 



Figure 13-15 UMR Wait Queue 



J 
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CONNECT-TO-INTERRUPT 

• Privileged task which contains interrupt service routine, ISR 

Task may or may not be mapped to Executive 

• Connect-to-interrupt directive (CINT$) used to set up 
interrupt service 

Interrupt Transfer Block (ITB) created in pool 

Address X.JSR in ITB loaded into PC of specified 
vector 

Vector must be greater than 60 and unused 

ITB contains code to map the ISR through KERNEL APR 5 and 
transfer control to it 

ITB also contains FORK block for ISR 

ITB linked to the ITB list of the task using T.CPCB in the 
TCB 

Task is made noncheckpointable and nonshuf flable 

• Connect-to-interrupt directive performs disconnect if issued 
with address of ISR equal to 

Task is made checkpointable and shufflable regardless of 
original status 

• Interrupt service routine is limited to 4K words 



382 



DEVICE DRIVER PROCESSING 




ITB 



DEVICE 
CONTROLLER 



INTERRUPT 



/ 



$INTSC 



ISR 



V 



CALL $INTSC 



MAP KAPR5 
OVER ISR 



CALL ISR 
SAVE R0-R3 






RTS PC 



$DIRXT 



Figure 13-16 Connect-to-Interrupt Processing 
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LINK TO NEXT ITB 



004737 



ADDRESS OF $INTSC 



-JSRR5. #$INTSC 



UNUSED 



LOW BYTE OF PSW FOR ISR 



INTERRUPT SERVICE ROUTINE ADDRESS (APR 5 MAPPING) 



LINK TO NEXT FORK BLOCK 



FORKBLOCK 



SAVED PC 



SAVED R5 



SAVED R4 



RELOCATION BIAS FOR APR5 



ADDRESS OF DISABLE INTERRUPT ROUTINE 



TCB ADDRESS OF OWNING TASK 



A.DQSR FOR AST BLOCK 



AST BLOCK 



VECTOR ADDRESS 



SAVED VECTOR PC 






X.LNK 


2 


X.JSR 


4 




6 


X.PSW 


10 


X.ISR 


12 


X.FORK 



X.REL 

X.DSI 

X.TCB 

X.AST 



X.VEC 
X.VPC 



1. IF AST SUPPORT THIS IS FIRST AND ONLY AST PARAMETER 



Figure 13-17 The Interrupt Transfer Block 



384 



.TITLE 
. I DENT 



DEVICE DRIVER PROCESSING 



CTI 
/i.O/ 



.;■* 



** THIS TASK ILLUSTRATES THE CONNECT TO INTERRUPT VECTOR DIRECTIVE 
THIS PRIVILEGED TASK CONNECTS TO A DR-11K. THERE IS A 
LOCAl OPERATOR CONSOLE (LOC BOX) ATTACHED TO THE DR-11K 
WHICH HAS 3 PUSH BUTTONS. THESE 3 SWITCHES WILL CAUSE 
THE DR-il TO INTERRUPT AND TO PERFORM THE FOLLOWING 

operations: 

SWITCH 1 - THE INTERRUPT SERVICE ROUTINE 

WILL SAMPLE THE TIME? AND STORE 
THE NUMBER OF TICKS TO THE NEXT 
SECOND IN A BUFFER. 

SWITCH 2 - THE ISR QUEUES AN AST TO THIS TASK 

WHICH WILL AVERAGE THE VALUES COLLECTED 
IN THE ISR AND PRINT IT ON 'TI'. 

SWITCH 3 - THE ISR SETS A LOCAL EVENT FLAG WHICH 
CAUSES THIS TASK TO DISCONNECT FROM 
THE VECTOR AND EXIT. 



FOR 



DRVEC 

DRCSR 

DRBUF 

SWTCH1 

8WTCH2 

SWTCH3 

EF 

BUFSIZ 

cint: 

DCINTS 
WAIT! 
PRINT J 
FORMAT i 
ERR I 

MESt 



.MCALL 

.NLIST 

DEFINITIONS 
230 
167770 
167772 
1 

- 2 
4 



CINT* 
CINT* 
WTSE* 
(HOW* 
.ASCIZ 
.ASCI2 
. EVEN 
. BL.KB 



CINT*»EXIT*S»QIOW*»ASTX*Si-WTSE*»DIR* 
BEX 

THE BR -UK 

J VECTOR 

5 CONTROL AND STATUS REGISTER 

i INPUT BUFFER REGISTER 

% SWITCH 1 

j SWITCH 2 

i SWITCH 3 

i EVENT FLAG FOR TASK 

J NUMBER OF SAMPLES TO STORE 



30. 

DRVEC * I SRBAS , DRINT , DREDI R , PR5 1 DRAST 

DRVEC S DISCONNECT 

EF ?WAIT FOR EF 

1 . W VB t 5 t 1 ? r > t <MES 1 f 40> 

/NUMBER OF SAMPLES TAKEN XD. 

/FAILED TO CONNECT TO VECTOR. 



! CONNECT 



i PRINT AVERAGE 
AVERAGE OF THE SAMPLES XO/ 
DIRECTIVE STATUS = XD./ 



100. 



y FORMATTED MESSAGE 



.ENABL L.SB 



MAIN LINE CODE 

CONNECT TO DR-11K INTERRUPT 

WAITING ON LOCAL EVENT FLAG 



VECTOR AN PUT TASK TO SLEEP BY 



START 



.to*: 



CLR 


COUNT 


CL.R 


BUFFER 


DIR* 


#CINT 


BCS 


10* 


DIR* 


♦WAIT 


DIR* 


♦DCINT 


EXITtS 




CONNECT 


FAILED 


MOV 


♦MEStRO 


MOV 


♦ERRjRI 



% INITIALIZE NUMBER OF SAMPLES 

y. INITIALIZE SUM 

i CONNECT TO INTERRUPT 

i FAILED TO CONNECT 

5 PUT TASK TO SLEEP 

5 DISCONNECT 



PRINT ERROR MESSAGE 



J OUTPUT 
.FORMAT 



BUFFER 
SPECIFICATION 



Example 13-4 



Sample Connect-to-Interrupt 
(Sheet 1 of 3) 
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MOV 
CALL. 
MOV - 
MR* 
EXIT*S 



**DSU»R2 5 VALUE TO BE CONVERTED 
*EDMSG j FORMAT MESSAGE 

RlrPRINT+Q.IOPL+2 J NUMBER OF BYTES IN MESSAGE 
•PRINT SPRINT ERROR MESSAGE 



AST WILL AVERAGE THE TIME SAMPLES AND PRINT ON TI 



drast; 



.1.5$: 



35*; 



MOV 


COUNT >RO 


i NUMBER OF SAMPLES 


BEQ 


35* 


fSKIP AVERAGING 


CLR 


Rl 


? ACCUMULATE SUM IN Rl 


MOV 


♦BUFFER j R2 


i SAMPLES TO SUM 


MOVE 


<R2>+,R3 


5 GET SAMPLE 


BIC 


♦177400, R3 


5 DON'T SIGN EXTEND 


ADD 


R3,R1 


rADD INTO TOTAL 


SOB 


ROs-15* 


J GET NEXT VALUE 


DIV 


COUNT f RO 


JGET AVERAGE 


MOV 


Rl, BUFFER 


5 STORE QUOTIENT 


MOV 


♦MES > RO 


r OUTPUT STRING 


MOV 


♦FORMAT 


r FORMAT SPECIFICATION 


MOV 


♦COUNT ,R2 


» NUMBERS TO CONVERT 


CALL. 


*EDMSG 


5 CONVERT MESSAGE 


MOV 


RlfPRINT+Q. 


IOPL+2 r NUMBER OF BYTES TO 


DIR* 


♦PRINT 


5 WRITE SAMPLE AVERAGE 


TST 


(SP> + 


> POP VECTOR ADDRESS 


CLR 


BUFFER 


5RE-INITIALIZE SUM 


CLR 


COUNT 


fAND COUNT OF SAMPLES 


ASTX*S 




JEXIT AST 



PRINT 



ISRBAS! 

COUNT J 
BUFFER I 



ISRBAS DEFINES THE BASE ADDRESS OF A 4K-W0RD AREA THE 
EXECUTIVE WILL MAP WITH KERNEL APRS. THIS AREA MUST 
CONTAIN THE INTERRUPT SERVICE ROUTINE r THE ENABLE/DISABLE 
INTERRUPT ROUTINEv AND ANY DATA AREAS THAT THESE ROUTINES 
WILL REFERENCE. 



DATA BUFFERS NEEDED BY ISR 



. WORD 
.BLKB 
.EVEN 




BUFSIZ 



r NUMBER OF SAMPLES 
f BUFFER FOR INPUTS 



ENABLE/DISABLE INTERRUPTS ROUTINE 
AUTOMATICALLY CALLED UNDER 3 CONDITIONS 

1. WHEN THE TASK CONNECTS TO AN INTERRUPT VECTOR 
TO ENABLE INTERRUPTS. 

2. WHEN THE TASK DISCONNECTS FROM THE INTERRUPT 
VECTOR TO DISABLE INTERRUPTS. 

3. WHEN THE TASK IS ABORTED TO DISABLE INTERRUPTS, 



dredir: 



20*: 



20* 

♦ 100>@«iRCSR 



BCS 

BIS 

RETURN 

DIG #100»@#DRCSR 

RETURN 



?IF CS DISABLE INTERRUPTS 

J ENABLE INTERRUPTS 

5 AND OUT 

^DISABLE INTERRUPTS 

i AND OUT 



INTERRUPT SERVICE ROUTINE 

THE ISR IS ENTERED AT PRIORITY 5 (SPECIFIED ON CINT*) WITH 
R4 = SAVED AND FREE TO BE USED 
R5 ~ ADDRESS OF FORK BLOCK IN THE ITB 



drint: BIT 



♦SWTCHl>@«iRBUF 5 P 5 INPUT BUFFER REQUEST? 



Example 13-4 Sample Connect-to-Interrupt Routine 

(Sheet 2 of 3) 
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BEQ 


30* 


CMP 


♦BUFSIZf COUNT 


BEQ 


50* 


MOV 


C0UNT.R4 


ADD 


PC r R4 


ADD 


♦BUFFER-. >R4 


MOVB 


G?**TTNS,<R4) 


INC 


COUNT 


BR 


50* 



iiflF EQ.» NO 
f»»YESi. BUFFER FULL? 
? ? S IF EQ* YES 
Hi. IF NE? NO 

a i calculate buffer 

jJJPIC ADDRESS TO STORE SAMPLE 
HiLQW BYTE OF TICKS TILL NEXT SECOND 
S H INCREMENT NUMBER OF SAMPLES 
5 5PEXIT FROM INTERRUPT 



V 

30*: 



INTERRUPT WAS FROM SWITCH 2 OR 3 

CALL <?#*F0RK2 ? J? CREATE A SYSTEM PROCESS 

CLR (R3) i DECLARE THE FORK BLOCK FREE 

BIT #SUTCH3»@#DRBUF ^DISCONNECT FROM INTERRUPT? 

BNE 40* ?IF NEf YES 



SWITCH 



QUEUE AN AST TO THE TASK 



CALL 
BR 



@#*QASTC 
50$ 



r QUEUE AN AST 

SEXIT FROM INTERRUPT 



SWITCH 3 => DISCONNECT FROM INTERRUPTS. 

SET LOCAL EVENT FLAG 2 TO WAKE UP TASK LEVEL CODE TO 

ISSUE THE DISCONNECT 



40*: MOV #EF»RO P EVENT FLAG 2 1"0 BE SET 

MOV X.TCB-X.F0RK(R5> tR5 ?R5 POINTS TO THE TCB OF TASK- 
CALL 0#*SETF SEXEC SUBROUTINE SETF 
RETURN »EXIT INTERRUPT 



50*: 



EXIT FROM INTERRUPT. TURN INTERRUPT BACK ON. 



BIS 
RETURN 



#100»y*DRCSR 



STURN ON INTERRUPTS 
5 EXIT FROM INTERRUPT 



ENSURE ISR + DATA + ENABLE/DISABLE SURBOUTINES FIT IN 4K 

.IIF LTr<20000 - <. - ISRBAS» .ERROR 
.END START 

Example 13-4 Sample Connect-to-Interrupt Routine 

(Sheet 3 of 3) 
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